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内 容 拓 要 


软件 质量 ， 不 但 依赖 于 架构 及 项 目 管理 ， 而 且 
与 代码 质量 紧密 相关 。 这 一 点 ， 无 论 是 敏捷 开发 流 
派 还 是 传统 开发 流派 ， 都 不 得 不 承认 。 


本 书 提出 一 种 观念 : 代码 质量 与 其 整洁 度 成 正 
比 。 干 津 的 代码 ， 既 在 质量 上 较为 可 徘 ， 也 为 后 期 
维护 、 升 级 黄 定 了 良好 基础 。 作 为 编程 领域 的 佼佼 
者 ， 本 书 作 者 给 出 了 一 系列 行 之 有 效 的 整洁 代码 操 
作 实 践 。 这 些 实践 在 本 书 中 体现 为 一 条 条 规则 (或 
称 “ 司 示 ”) ， 并 辅 以 来 和 目 现 实 项 目的 正 、 及 两 面 的 
抑 例 。 只 要 遵循 这 些 规则 ， 残 能 编写 出 干净 的 代 
码 ， 从 而 有 效 握 升 代 码 质量 。 


本 书 阅 读 对 象 为 一 切 有 志 于 改善 代码 质量 的 程 
序 员 及 技术 经 理 。 书 中 介绍 的 规则 均 来 自作 者 多 年 
的 实践 经 验 ， 涵 兰 从 命名 到 重 构 的 多 个 编程 方面 ， 
里 为 一 “家 ”之 言 ， 然 诚 有 可 资信 鉴 的 价值 。 














大 村 封面 


封面 的 图 片 是 M104: $Æ (The Sombrero 
Galaxy) > M104^4^ 75 T Nb 2c] (Virgo) ， 距 地 球 
仅 3000 万 光 年 。 其 核心 是 一 个 质量 超大 的 黑洞 ， 有 
100 万 个 太阳 那么 重 。 


这 幅 图 是 否 让 你 想起 了 Klingon 星 球 ( 元 林 
贡 ) Ul 的 卫星 Praxis 〈 普 拉 西 斯 ) 爆炸 的 事 ? 我 清 
楚 地 记得 ， 在 《 星 舰 迷航 VI》 中 ， 大 爆炸 之 后 俊 
片 四 溅 ， 飞 舞 出 一 个 赤道 光环 的 场景 。 至 此 ， 光 环 
驶 成 为 科 弥 电影 中 爆炸 场景 的 必然 产物 了 。 甚 至 丈 
在 《 星 般 迷航》 系列 电影 的 后 续 情 节 中 ， 
Alderaan 《阿尔 德 然 〉 的 爆炸 也 有 类 似 场 景 出 现 。 


环绕 M104 的 光环 是 什么 造成 的 ? 它 为 何 会 有 
如 此 巨大 的 脱 胀 率 和 如 此 明亮 而 微小 的 内 核 ? 在 我 
看 来 ， 仿 佛 那 位 于 中 心 位 置 的 黑洞 勃然 大 怒 ， 向 星 
系 的 中 心 扔 出 了 一 个 3 万 光 年 大 的 洞 一 般 。 在 这 场 
宇宙 大 有 骨 声 所 及 范围 之 内 的 居民 全 都 大 难 临 凑 了 。 


超大 质量 的 黑洞 以 星体 为 食 ， 将 星体 的 相当 部 
分 质量 转换 为 能 量 。 方 程式 E =MC “已 经 足够 体现 
杠杆 作用 了 ， 但 当 M 有 一 笑星 体 那 么 大 的 质量 时 ， 
看 吧 ! 在 那 巨 兽 酒 足 饭 饱 之 前 ， 有 多 少 星 体会 一 头 












































撞 进 它 的 肯 里 ? 核心 部 分 空 铜 的 大 小 ， 是 售 说 明了 
EET A We ? 





封面 图 片 : 来 自 斯 比 译 太空 望远镜 
封面 上 的 M104 图 乒 ， 是 用 来 自 于 哈 荡 望远镜 


的 那 幅 著名 的 可 见 光 相片 CERD 和 Spitzer〈 斯 比 
泽 ) 轨道 探测 器 最 新 的 红外 影像 (下 图 ) 组 合 而 
成 。 


在 红外 影像 中 ， 光 坏 中 的 热 粒子 内 次 着 穿 过 了 
中 心 膨胀 体 。 这 两 幅 影 像 组 合 起 来 ， 显 现 出 我 们 从 
E 过 的 景象 ， 展 示 了 久远 之 前 曾 能 能 燃 烧 的 火 
18 








[1] 系列 剧 《 星 舰 迷 航 》 (Star Trek) 中 的 故事 情 
节 ，Praxis 星 焊 炸 ， 由 此 导致 联邦 和 Klingon 达 成 首 
次 和 平 协议 。 
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AUR (Ga-Jol) EEF Ae ee SEU QUE BE ZR m FF 
之 一 ， 它 浓郁 的 甘草 味道 ， 完 美 地 弥补 了 此 地 潮湿 
FIN FEO IA MPI RHEL AEA, ABT 
WADA FEF Ee a TE ED il] A Seo <P KS 
TAPER, HER ERB SJ EB: 





Ærlighed i sma ting er ikke nogen lille ting. 


“小 处 城 实 非 小 事 。” 这 句 话 正好 是 我 想 在 这 里 
说 的 。 以 小 见 大 。 本 书写 到 了 一 些 价值 殊 胜 的 小 主 
题 。 


神 在 细节 之 中 ， 建 筑 师 Ludwig mies van der 
Rohe 〈 路 德 维 希 : 密 斯 : 范 : 德 . 罗 ) LU 如 是 说 。 这 名 
话 引发 了 有 关 软 件 开发 、 特 别 是 敏捷 软件 开发 中 架 
构 所 处 地 位 的 若干 争论 。 鲍 过 (Bob) UT 和 我 时 党 
FGA CUT AX Te. wee, Ludwig mies 
van der Rohe 的 确 专注 于 效用 和 基于 宏伟 架构 之 上 
的 永恒 建筑 形式 。 然 而 ， 他 也 为 自己 设计 的 每 所 房 
屋 挑选 每 个 门 把 手 。 为 什么 ”因为 小 处 见 大 。 


就 TDD P1 话题 展开 目前 仍 在 继续 的 “ 辩 
论 ” 时 ， 鲍 勃 和 我 认识 到 ， 我 们 均 同 意 软件 架构 在 








开 及 中 占据 重要 地 位 ， 但 就 其 确切 音义 而 言 ， 我 们 
之 间 还 有 分 上 鉴 。 然 而 ， 这 种 巴 与 盾 咒 利 的 讨论 相对 
而 言 并 不 重要 ， 因 为 在 项 目 开 始 之 时 ， 我 们 理 所 当 
然 应 该 让 专业 人 士 投 入 些许 时 间 去 思考 及 规划 。20 
世纪 90 年 代 末期 有 关 仪 以 测试 和 代码 驱动 设计 的 
概念 已 一 去 不 返 。 相 对 于 任何 宏伟 愿景 ， 对 细节 的 
关注 甚至 是 更 为 天 键 的 专业 性 基础 。 弟 和 完 ， 开 发 者 
通过 小 型 实践 获得 可 用 于 大 型 实践 的 技能 和 信用 
度 。 其 次 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 天 不 紧 
的 门 、 有 点 儿 没 铺 平 的 地 板 ， 甚 至 是 凌乱 的 蝎 面 ， 
这 束 是 整洁 代码 
BE 


架构 只 是 软件 开发 用 到 的 借 喻 之 一 ， 主 要 用 在 
那 种 等 同 于 建筑 师 交 付 毛 坯 房 一 般 交 付 初 始 软件 产 
m 的 场合 。 在 Scrum 和 敏捷 (Agile) 的 日 子 里 ， 人 
们 关注 的 是 快速 将 产品 推 癌 市 场 。 我 们 要 求 工厂 全 
速 运转 、 生 产 软件 。 这 就 是 人 类 工厂 : 全 思考 、 会 
感受 的 编 鸽 人， 他 们 由 产品 备 瑟 或 用 户 故 事 开 始 创 
造 产 品 。 来 自制 造 业 的 借 喻 在 这 种 场合 大 行 其 
道 。 例 如 ，Scrum 束 从 装配 线 式 的 日 本 汽车 生产 方 
式 中 获 益 民 多 。 


即便 是 在 汽车 工业 里 ， 大 量 工作 也 并 不 在 于 生 
产 而 在 于 维护 一 一 或 避免 维护 。 对 于 软件 而 言 ， 百 
分 之 八 十 或 更 多 的 工作 量 集 中 在 我 们 美 其 名 日 “ 维 





















































护 ” 的 事情 上 : 其 实 束 是 修 修 补 补 。 与 其 接受 西方 
天 于 制造 好 软件 的 传统 看 法 ， 不 如 将 其 看 作 建 筑 工 
业 中 的 房屋 修理 工 ， 或 者 汽车 领域 的 汽 修 工 。 日 本 
式 管理 对 于 这 种 事 怎么 说 的 呢 ? 


大 约 在 1951 年 ， 一 种 名 为 “全 员 和 生产 维 
护 ”(Total Productive Maintenance, TPM) 的 质量 
保证 手段 在 日 本 出 现 。 它 关注 维护 其 于 关注 生产 。 
TPM 的 主要 支柱 之 一 是 所 谓 的 5S 原 则 体系 。5S 是 一 
套 规程 ， 用 “规程 ”这 个 词 ， 是 为 了 读者 便于 理解 。 
SSEM RSE a (Lean) 西方 视野 中 的 一 个 
时 比 词 ， 也 是 在 软件 领域 渐 领 风 骚 的 时 比 词 的 
AME. EWKA (Uncle Bob) 在 前 言 中 
写 到 的 ， 良 好 的 软件 实践 遵循 这 些 规程 ， 专注、 镇 
定 和 思考 。 这 并 非 吕 只 有 关 实 作 ， 有 关 推 动工 三 设 
备 以 最 高 速度 运转 。5S$ 哲 学 包括 以 下 概念 : 
































e SEE (Seiri) 呈 ， 或 谓 组 织 〈 想 想 英 语 中 的 
sort (Æ, HEF) 一 词 ) 。 搞 清楚 事物 之 所 在 
通过 恰当 地 命名 之 类 的 手段 BRE 
要 。 沉 得 命名 标识 无 关 紧 要 ? dn BET ee 
吧 。 
整顿 (Seiton) ， 或 谓 整 齐 〈 想 想 瑞 文中 的 
systematize (系统 化 ) 一 词 ) 。 有 人 句 美 国 老话 
w: 物 和 缘 有 其 位 ， 而 后 物 尽 归 其 位 (A place 


for everything, and everything in its place) 。 每 段 














代码 都 该 在 你 希望 它 所 在 的 地 方 一 一 如 果 不 在 
ASH, mimm. 

e 清楚 (Seiso) ， 或 谓 清洁 〈 想 想 英 文中 的 
shine (#240) 一 词 ) 。 清 理工 作 地 的 拉线 、 油 
污 和 边 角 废 料 。 对 于 那 种 四 处 遗弃 的 市 注释 的 
代码 及 反映 过 往 或 期 望 的 无 注释 代码 ， 本 书 作 
者 怎么 说 的 来 着 ? 除 之 而 后 快 。 

e iai (Seiketsu) ， 或 谓 标准 化 。 有 天 如 何 保持 
工作 地 清洁 的 组 内 共识 。 本 书 有 没有 提 到 在 开 
发 组 内 使 用 一 贯 的 代码 风格 和 实践 手段 ”这些 
标准 从 哪里 来 ? 读 读 看 。 

e FÆ (Shitsuke) l, Wia (H). Æ 
实践 中 贯彻 规程 ， 并 时 时 体现 于 个 人 工作 上 ， 
而 且 要 乐于 改进 。 


如 果 你 接受 挑战 一 一 没 错 ， 就 是 挑战 ， 阅 读 并 
应 用 本 书 ， 你 就 会 理解 和 赞赏 上 述 最 后 一 条 。 我 们 
最 终 是 在 驶 向 一 种 负责 任 的 专业 精神 之 根源 所 在 ， 
这 种 专业 性 隶属 于 一 个 关注 产品 生命 周期 的 专业 领 
域 。 在 我 们 遵循 TPM 来 维护 机 动车 和 其 他 机 械 时 ， 
停机 维护 一 一 等 待 缺陷 显现 出 来 一 一 并 不 常见 。 我 
们 更 上 一 层 楼 : 每 天 检查 机 械 ， 在 磨损 机 件 停 止 工 
作 之 前 就 换 挥 它 ， 或 者 按 常 例 每 1000 瑞 里 〈( 约 
1609.3km) 束 更 换 润 消 油 、 防 止 磨损 和 开裂 。 对 于 
代码 ， 应 无 情 地 做 重 构 。 还 可 以 更 进一步 ， 就 像 
TPM 运 动 在 50 多 年 前 的 创新 : 一 开始 束 打 造 更 易 维 























护 的 机 械 。 写 出 可 读 的 代码 ， 重 要 程度 不 亚 于 写 出 
可 执行 的 代码 。1960 年 左右 ， 围 绕 TPM 引 入 的 终极 
实践 Cultimate practice) ， 关 注 用 全 新 机 械 符 代 旧 
机 械 。 诚 如 Fred Brooks 所 言 ， 我 们 或 许 应 该 每 7 年 
束 重 做 一 次 软件 的 主要 模块 ， 清 理 绥 乙 陈 愉 的 代 
人 码 。 也 许 我 们 该 把 重 构 周 期 从 以 年 计 缩 短 到 以 周 、 
以 天 甚至 以 小 时 计 。 那 便 是 细节 所 在 了 。 


细节 中 和 目 有 天 地 ， 而 在 生活 中 应 用 此 类 手段 时 
也 有 微 言 大 义 ， 束 像 我们 一 成 不 变 地 对 那些 源 目 日 
本 的 做 法 寄予 厚望 一 般 。 这 并 非 只 是 东方 的 生活 
观 ; 英美 民间 也 过 是 这 类 警句 。 上 引 “ 整 
W” CSeiton) 二 字 就 曾 出 现在 某 位 俄亥俄 州 牧师 的 
笔下 ， 他 把 齐整 看 作 是 “ 荡 潍 种 种 罪恶 之 民 
方 ”。“ 清 楚 ”(Seiso) Mant We? Mea FS 
(Cleanliness is next to godliness )。 一 张 脏 乱 的 桌 
子 足 以 奔 去 一 所 丽 宅 的 光彩 。 老 话 怎么 说 “ 寻 
R” CShitsuke) HJ? FRADA (He who 
is faithful in little is faithful in much，〉。 对 于 时 时 准 
A TE tet ST ALB, IRRIKA EARE 
础 ， 而 不 是 置 诸 脑 后 ， 有 什么 说 法 吗 ? 及 时 一 针 省 
九 针 (A stitch in time saves nine) 。 早 起 的 鸟 儿 有 
HIZ (The early bird catches the worm) 。 日 事 日 毕 
( Don't put off until tomorrow what you can do 
today) >- E AKKA EWM FA, 
是 其 所 谓 “ 最 后 时 机 ?的 本 义 所 在 。 摆 正 单项 工作 在 














整体 中 的 位 置 呢 ? 巨 木 生 于 树 籽 (Mighty oaks 
from little acorns grow) 。 如 何在 日 常生 活 中 做 好 简 
单 的 防备 性 工作 呢 ? 防 病 好 过 治 病 (An ounce of 
prevention is worth a pound of cure) 。 一 天 一 平 

果 ， 医 生 远 离 我 (An apple a day keeps the doctor 
away) 。 整 洁 代 人 码 以 其 对 细 市 的 关注 ， 采 浴 了 深 埋 
于 我 们 现 有 、 或 曾 有 、 或 该 有 的 壮丽 文化 之 下 的 智 
意 根源 。 


即便 是 在 宏伟 的 建筑 作品 中 ， 我 们 也 听 到 关注 
细节 的 回 啊 。 想 想 Ludwig mies van der Rohe 的 门 把 
手 吧 。 那 正 是 整理 (seiri) 。 认 真 对 竺 每 个 变量 
名 。 你 当 用 为 自己 第 一 个 孩子 命名 般 的 谨慎 来 给 变 


量 命 名 。 


正如 每 位 房 主 所 知 ， 此 类 照料 和 修 昔 永 无 休 
止 。 建 筑 师 Christopher Alexander 模式 与 模式 语 
这 把 每 个 设计 动作 看 作 是 较 小 的 局 部 修复 
动作 。 他 认为 ， 设 计 民 好 结构 才 是 建筑 师 的 本 职 所 
在 ， 而 更 大 的 建筑 形态 则 当 留 给 模式 及 居住 者 搬 进 
的 家 私 来 完成 。 设 计 始 终 在 持续 进行 ， 不 只 是 在 新 
建 一 个 房间 时 ， 也 在 我 们 重新 粉刷 墙 面 、 更 换 旧 地 
毯 或 者 换 厨 房 水 槽 时 。 大 多 数 艺 术 门 类 也 持 类 似 主 
张 。 在 寻找 其 他 推 染 细 节 的 人 时 ， 我 们 发 现 ，19 世 
纪 法 国 作 家 Gustav Flaubert 〈 古 斯 塔 夫 . 福 楼 拜 ) 名 
列 其 中 。 法 国 诗人 Paul Valery〈 保 尔 : 瓦 雷 里 ) 认 









































为 ， 每 首 诗 歌 都 无 写 完 之 时 ， 得 持续 重 写 ， 直 全 放 
茎 为 止 。 全 心 倾 注 于 细节 ， 屡 见于 退 求 早 越 的 行为 
之 中 。 虽 然 这 无 甚 新意， 但 阅读 本 书 对 读者 仍 是 一 
种 挑战 ， 你 要 重 拾 入 已 弃置 脑 后 的 民 好 规则 ， 自 发 
自主 ,，“ 啊 应 改变 ”。 


不 驻 的 是 ， 我 们 往往 见 不 到 人 们 把 对 细节 的 天 
注 当 作 编程 艺术 的 基础 要 件 。 我 们 过 早 地 放弃 了 在 
代码 上 的 工作 ， 并 不 是 因为 它 业 已 完成 ， 而 是 因为 
我 们 的 价值 体系 关注 外 在 表现 其 于 关注 要 交付 之 物 
HEM. MARAA h ER: 坏 东 西 一 再 出 现 
。 无 论 是 在 行业 里 还 是 学 术 领 域 ， 研 究 者 都 很 重视 
代码 的 整洁 问题 。 供 职 于 贝尔 软件 生产 研究 实验 室 
(Bell Labs Software Production Research?) 一 -一 六 
fü, NEP! 时 ， 我 们 有 些 不 太 严 密 的 发 
现 ， 认 为 前 后 一 致 的 缩 进 风 格 明 显 标志 了 较 低 的 缺 
陷 率 。 我 们 原 指 望 将 质量 归 因 于 架构 、 编 程 语言 或 
者 其 他 高 级 概念 ， 我们 的 专业 能 力 归 功 于 对 工具 的 
掌握 和 各 种 高 高 在 上 的 设计 方法 ， 至 于 那些 安置 于 
三 区 的 机 器 ， 那 些 编码 者 ， 他 们 居然 通过 人 简单 地 保 
持 一 致 缩 进 风格 创造 了 价值 ， 这 人 简直 是 一 种 侮辱 。 
我 在 17 年 前 就 在 书 中 写 过 ， 这 种 风格 远 不 止 是 一 种 
单纯 的 能 力 那 么 简单 。 日 本 式 的 世界 观 深 知 日 帝 工 
作者 的 价值 ， 而 且 ， 还 深 知 工作 者 简单 的 日 音 行 为 
所 锻造 的 开发 系统 的 价值 。 质 量 是 上 百 万 次 全 心 投 
入 的 结果 一 一 而 非 仅 归功 于 任何 来 自 天 向 的 伟大 方 
























































法 。 这 些 行为 简单 却 不 简陋 ， 也 不 意味 痢 简 易 。 相 
有 反 ， 它 们 是 人 力 所 能 达 的 不 仅 伟 大 而 且 美 丽 的 造 
Wo BMS EN, MARE ANTENA « 


当然 ， 我 仍然 提倡 放宽 思路 ， 也 推 有 寻根 植 于 深 
厚 领 域 知识 和 软件 可 用 性 的 各 种 架构 手法 的 价值 。 
但 本 书 与 此 无 天 至 少 ， 没 有 明显 关系 。 本 书 精 
wok, HER, BACAR. CIES 
Peter Sommerlad. Kevlin Henny Giovanni Asproni 
SE HC IE S TMEN AMSA AeA. f 15x 
WARES BN ih a EIER RV". RIEN, Zl 
就 是 程序 ， 而 且 其 结构 也 极 大 地 反映 出 程序 结构 ， 
但 也 理应 始终 说 还 地 承认 设计 存在 于 代码 中 ， 这 到 
关 紧 要 。 制 造 上 的 返工 导致 成 本 上 升 ， 但 重 做 设计 
却 创造 出 价值 。 我 们 应 当 视 代码 为 设计 一 一 作为 过 
程 而 非 终 点 的 设计 这 种 高 尚 行为 的 漂亮 体现 。 
灯 合 与 内 聚 的 架构 韵律 在 代码 中 脉动 。Larry 
Constantine 以 代码 的 形式 而 不 是 用 UML 那 种 高 
高 在 上 的 抽象 概念 Ad. Richard 
Garbriel#E “Abstraction Descant” (WRAN) — 

告诉 我 们 ， 抽 象 即 恶 。 代 码 除 恶 ， 而 整洁 的 代码 
WW OK FRE Ei YY 


ERRIAN AR EL a REE e 
一 下 ， 那 句 丹 卖 谚语 不 只 是 教 我 们 重视 小 处 ， 更 教 
我 们 小 处 要 诚实 。 这 意味 痢 对 代码 减 实 、 对 同僚 









































坦承 代码 现状 ， 最 重要 的 是 在 代码 问题 上 不 目 其 。 
是 否 已 尽 人 全力“ 把 露营 地 清理 得 比 来 时 还 干净 ”? 签 
入 代码 前 是 否 已 做 重 构 ?这 可 不 是 皮毛 小 事 ， 它 正 
高 卧 于 敏捷 价值 的 正中 位 置 。Scrum 有 一 种 建议 的 
实践 ， 主 张 重 构 是 “完成 ”(Done) 概念 的 一 部 分 。 
无 论 是 染 构 还 是 代码 都 不 强求 完美 ， 只 求 竭诚 尽力 
而 已 。 人 束 无 过 ， 神 处 容 之 (To err is human; to 

forgive, divine) 。 在 Scrum 中 ， 我 们 使 一 切 可 见 。 

PUTTAR HE EAC AR FREER ARISTA, AE KAS 
完美 。 我 们 日 渐 成 为 完整 的 人 ， 配 得 起 神 的 眷顾 ， 
也 越 来 越 接 近 细 节 中 的 伟大 之 处 。 


在 目 己 的 专业 领域 中 ， 我 们 吸 需 能 得 到 的 一 切 
帮助 。 假 使 干净 的 地 板 能 减少 事故 友 生 ， 假 使 归 置 
到 位 的 工具 能 提升 生产 力 ， 我 也 会 倾 力 做 到 。 全 于 
本 书 ， 在 我 看 过 的 有 关 将 精益 原则 应 用 于 软件 的 印 
刷 品 中 ， 是 最 其 实用 性 的 。 那 班 求索 者 多 年 来 并 屑 
香 斗 ， 不 但 是 为 求 一 己 之 进步 ， 更 将 他 们 的 知识 通 
过 和 你 手 上 正在 做 的 事 一 般 的 工作 贡献 给 这 个 行 
Meo AHA a Rta Zia, KAHL, E7 
竟 略 有 改善 了 。 


对 高 瞻 远 瞩 的 练习 业已 结束 ， 我 要 去 清理 自己 
HPR IS o 
























































James O. Coplien T HŽ IKEY 


[1] 详 注 :20 世纪 中 期 著名 现代 建筑 大 师 ， 乘 
承 “ 少 即 是 多 ”的 建筑 设计 将 和 学， 缔造 了 玻璃 者 载 等 
现代 建筑 结构 。 


[2] ”译注 : 本 书 主要 作者 Robert C. Martin 绰 号 
Uncle Bob, ix FAY “#3” A Je CA “A GA 
+4Robert C. Martin. 


[3] “译注 : Test Driven Development， 测 试 驱 动 开 
[4] 译注: 这些 概念 最 初出 现 于 日 本 ，5 个 概念 的 
日 文 罗马 字 拼 首 首 字母 正好 都 是 5， 所 以 这 里 也 保 

留 了 日 文 罗马 字 拼 音 写 法 。 中 译本 以 日 文 汉 字 直 接 
译 出 ， 读 者 留意 ， 不 可 直接 对 应 其 中 文 意思。 

[5] 译注: PLAN GR. WU. 
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OF Code Quaciry: WTFs/ninutre 有 效 标准 : WTF/min 








Good Code.. BAd code. 


承 Thom Holwerda# fù, FE 
http://www.osnews.com/story/19266/WTFs m 再 制 


你 的 代码 在 哪 道 门 后 面 ? 你 的 团队 或 公司 在 哪 
道门 后 面 ? 为 什么 会 在 那里 ? 只 是 一 次 普通 的 代码 
复查 ， 还 是 产品 面世 后 才 发 现 一连 串 严重 问题 ?我 
们 是 否 在 战 战 茵 天 地 调试 自己 之 前 错 以 为 没 问 题 的 
代码 ?客户 是 否 在 流失 ? 经 理 们 是 否 把 我 们 盯 得 如 
CRER? 当 事 态 变 得 严重 起 来 ， 如 何 保证 我 们 在 
那 道 正确 的 门 后 做 补救 工作 ? 答案 是 : 技艺 


(craftsmanship) 。 


习 艺 之 要 有 二 : 知 和 行 。 你 应 当 习 得 有 关 原 
则 、 模 式 和 实践 的 知识 ， 穷 尽 应 知之 事 ， 并 且 要 对 
其 了 如 指 掌 ， 通 过 刻 苗 实践 掌握 它 。 


我 可 以 教 你 骑 目 行车 的 物理 学 原理 。 实 际 上 ， 
经 典 数 学 的 表达 方式 相对 而 言 确 实 人 简洁 明了 。 重 
力 、 摩 擦 力 、 和 角 动 量 、 质 心 等 ， 用 一 页 写 满 方程 式 
的 纸 束 能 说 明白 。 有 了 这 些 方程 式 ， 我 可 以 为 你 证 
明 出 骑 车 完全 可 行 ， 而 且 还 可 以 告诉 你 骑 车 所 需 的 
ee een ee 
"Ed. 


编码 亦 同 此 理 。 我 们 可 以 写 下 整 涪 代码 的 所 
有 “感觉 民 好 ”的 原则 ， 放 手 让 你 去 干 GRAZ, iE 
你 从 自行 车 上 摔 下 来 ) 。 那 样 的 话 ， 我 们 算是 哪 门 
子 老 师 ? 而 你 又 会 成 为 怎样 的 学 生 呢 ? 


不 ! 本 书 可 不 会 这 么 做 。 


学 写 整洁 代码 很 难 。 它 可 不 止 于 要 求 你 掌握 原 
则 和 模式 。 你 得 在 这 上 面 花 工夫 。 你 须 目 行 实 践 ， 
且 体 验 目 己 的 失败 。 你 须 观 察 他 人 的 实践 与 失败 。 
WANA AGE HEPES FRR SL TFET 
FEN. TRUE AI A ce St OS TC DER M 
rE IMs] JJ T RR RAT AT e 


























阅读 本 书 要 多 用 心思 。 这 可 不 是 那 种 降落 前 就 
能 读 完 的 “感觉 不 错 ” 的 飞机 书 。 本 书 要 让 你 用 功 ， 
而 且 是 非 第 用 功 。 如 何 用 功 ? 阅读 代码 一 一 大 量 代 
码 。 而 且 你 要 去 琢磨 作 段 代码 好 在 什么 地 方 、 坏 在 
什么 地 方 。 在 我 们 分 解 ， 而 后 组 合 模 块 时 ， 你 得 亦 
步 亦 趋 地 跟 上 。 这 得 化 些 工夫 ， 不 过 值得 一 试 。 


本 书 大 致 可 分 为 3 个 部 分 。 前 儿 章 介绍 编写 整 
洁 代码 的 原则 、 模 式 和 实践 。 这 部 分 有 相当 多 的 示 
例 代 码 ， 读 起 来 左 具 挑战 性 。 读 完 这 几 半 ， 束 为 阅 
读 第 2 部 分 做 好 了 准备 。 如 果 你 束 此 止步 ， 只 能 祝 
你 好 运 啦 ! 


第 2 部 分 最 需要 花 工 夫 。 这 部 分 包括 几 个 复杂 
性 不 断 增 加 的 案例 研究 。 每 个 案例 都 清理 一 些 代 码 
把 有 问题 的 代码 转化 为 问题 少 一 些 的 代码 。 这 
部 分 极为 详细 。 你 的 思维 要 在 讲解 和 代码 段 之 间 跳 
来 跳 去 。 你 得 分 机 和 理解 那些 代码 ， 琢 磨 每 次 修改 
的 来 龙 去 脉 。 


你 付出 的 殊 动 将 在 第 3 部 分 得 到 回报 。 这 部 分 
只 有 一 草 ， 列 出 从 上 述 采 例 研究 中 得 到 的 局 示 和 灵 
感 。 在 忆 哆 和 清理 采 例 中 的 代码 时 ， 我 们 把 每 个 操 
作 理 由 记录 为 一 种 局 示 或 灵感 。 我 们 尝试 去 理解 目 
己 对 阅读 和 修改 代码 的 反应 ， 尺 力 了 解 为 什么 会 有 
这 样 的 感受 、 为 什么 会 如 此 行事 。 结 果 得 到 了 一 套 


























描述 在 编写、 了 阅读、 清理 代码 时 思维 方式 的 知识 
FE. 


如 果 你 在 阅读 第 2 部 分 的 案例 研究 时 没有 好 好 
用 功 ， 那 么 这 套 知 识 库 对 你 来 说 可 能 所 值 无 几 。 在 
这 些 案 例 研 究 中 ， 每 次 修改 部 仔细 注 明 了 相关 局 示 
的 标号 。 这 些 标 写 用 方 括 写 标 出 ， 如 : [H22]。 由 
此 你 可 以 看 到 这 些 局 示 在 何 种 环境 下 被 应 用 和 编 
Bo JAAR ME, Jaa SRB OTT Pia EES 
的 具体 决策 之 间 的 关系 才 有 价值 。 


如 果 你 跳 过 采 例 研究 部 分 ， 只 阅读 了 第 1 部 分 
和 第 3 部 分 ， 那 整 不 过 是 又 看 了 一 本 关于 写 出 好 软 
件 的 “感觉 不 错 ? 的 书 。 但 如 条 你 衣 花 时 间 琢 磨 那 些 
案例 ， 亦 步 亦 趋 一 一 站 在 作者 的 角度 ， 迫 使 目 己 以 
作者 的 思维 路 径 考 虑 问题 ， 束 能 更 深刻 地 理解 这 些 
原则 、 模 式 、 实 践 和 启示 。 这 样 的 话 ， 就 像 一 个 熟 
Zu Eye Y Ja ep, AT TEL IAE Er TIT 
延伸 部 分 那样 ， 对 你 来 说 ， 本 书 所 介绍 的 整洁 代码 
的 原则 、 模 式 、 实 践 和 局 示 就 成 为 了 本 号 具有 的 技 
蕊 ， 而 不 再 是 “感觉 不 错 ” 的 知识 。 
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致谢 
插图 


感谢 两 位 艺术 家 Jennifer Kohnke 和 Angela 
Brooks。Jennifer 绘 制 了 每 革 起 始 处 创意 新 帘 、 效 果 
惊人 的 插图 ， 以 及 Kent Beck, Ward Cunningham, 
Bjarne Stroustrup. Ron Jeffries、Grady Booch、 
Dave Thomas. Michael Feathers 和 我 本 人 的 肖像 。 


Angela 绘 制 了 文中 那些 精致 的 插图 。 这 些 年 她 
为 我 男 了 一 些 男 ， 包 括 Agile Software Development: 
Principles, Patterns, and Practices 〈 中 译 版 《敏捷 软 
件 开 发 : 原则 、 模 式 与 实践 》) 一 书 中 的 大 量 插 
图 。 她 是 我 的 长 女 ， 营 给 我 种 来 极 大 的 愉悦 。 








第 1 半 ”整洁 代码 





阅读 本 书 有 两 种 原因 : 第 一 ， 你 是 个 程序 员 ; 
第 二 ， 你 想 成 为 更 好 的 程序 员 。 很 好 。 我 们 需要 更 


好 的 程序 员 。 
这 是 本 有 关 编 写 好 程序 的 书 。 它 充斥 着 代码 。 





我 们 要 从 各 个 方 问 来 考察 这 些 代 码 。 从 顶 癌 下 ， 从 
后 往 上 ， 从 里 而 外 。 读 完 后 ， 束 能 知道 许多 关于 代 
码 的 事 了 。 而 且 ， 我 们 还 能 说 出 好 代码 和 糟糕 的 代 
码 之 间 的 差异 。 我 们 将 了 解 到 如 何 写 出 好 代码 。 我 
们 也 会 知道 ， 如 何 将 糖 糕 的 代码 改 成 好 代码 。 


1.1 要 有 代码 


有 人 也 许 会 以 为 ， 关 于 代码 的 书 有 点 儿 洲 后 于 
时 代 一 一 代码 不 再 是 问题 ， 我 们 应 当 关 注 模型 和 需 
求 。 确 实 ， 有 人 说 过 我 们 正在 临近 代码 的 终结 点 。 
很 快 ， 代 码 就 会 自动 产生 出 来 ， 不 需要 再 人 工 编 
写 。 程 序 员 完全 没 用 了 ， 因 为 商务 人 士 可 以 从 规约 
直接 生成 程序 。 


扯淡 ! 我 们 永远 抛 不 挥 代码 ， 因 为 代码 呈现 了 
需求 的 细 蔬 。 在 共 些 层面 上 ， 这 些 细节 无 法 被 忽略 
或 抽象 ， 必 须 明确 之 。 将 需求 明确 到 机 豆 可 以 执行 
oo 
古代 但 。 


我 期 望 语言 的 抽象 程度 继续 捉 升 。 我 也 期 望 领 
域 特定 语言 的 数量 继续 增加 。 那 会 是 好 事 一 柱 。 但 
那 终结 不 了 人 代码。 实际 上 ， 在 较 遍 层次 上 用 领域 特 
定语 言 撰写 的 规约 也 将 是 代码 ! 它 也 得 严 说、 精 
确 、 规 范 和 详细 ， 好 让 机 器 理解 和 执行 。 


那 帮 以 为 代码 终 将 消失 的 伙计 ， 丈 像 是 巴 望 看 
发 现 一 种 无 规范 数学 的 数学 家 们 一 般 。 他 们 巴 望 
a, BA AREER las, RAR RA, 
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解 我 们 ， 只 有 这 样 ， 它 才能 把 含糊 不 清 的 需求 翻 详 
为 可 完美 执行 的 程序 ， 精 确 满足 需求 。 


这 种 事 永远 不 会 发 生 。 即 便 是 人 类 ， 倾 其 全 部 
的 下 觉 和 创造 力 ， 也 造 不 出 满足 客户 模糊 感觉 的 成 
功 系 统 来 。 如 果 说 需求 规约 原则 教 给 了 我 们 什么 ， 
那 束 是 归 萤 民 好 的 需求 就 像 代码 一 样 正 式 ， 也 能 作 
为 代码 的 可 执行 测试 来 使 用 。 


记 住 ， 代 码 确 然 是 我 们 最 终 用 来 表达 需求 的 那 
种 语言 。 我 们 可 以 创造 各 种 与 需求 接近 的 语言 。 我 
们 可 以 创造 帮助 把 需求 解析 和 汇 整 为 正式 结构 的 各 
种 工具 。 然 而 ， 我 们 永远 无 法 抛弃 必要 的 精确 性 
一 一 所 以 代码 永存 。 




















1.2” 精 猴 的 代码 


最 近 我 在 读 Kent Beck34 Implementation Patterns 
(中 译 版 《实现 模式 》) [一 书 的 序言 。 他 这 样 
写 道 :“...... 本 书 基于 一 种 不 太 牢 徘 的 前 提 : 好 代 
码 的 确 重 要 ..…….….” 这 前 提 不 牢靠 ?我 反对 ! 我 认为 
这 是 该 领域 最 强 回 、 节 党 文 持 、 最 被 强调 的 前 捍 了 
(我 想 Kent 也 知道 ) 。 我 们 知道 好 代码 重要 ， 征 因 

为 其 短缺 实在 困扰 了 我 们 太 久 。 























20 蔬 纪 80 年 代 末 ， 有 家 公司 写 了 个 很 流行 的 杀 
手 应 用 ， 许 多 专业 人 士 都 买 来 用 。 然 后 ， 发 布 周 期 
开始 拉 长 。 缺 陷 总 是 不 能 修复 。 装 载 时 间 越 来 越 
久 ， 骨 省 的 几率 也 越 来 越 大 。 至 今 我 还 记得 自己 在 
某 天 泪 丧 地 关 掉 那个 程序 ， 从 此 再 不 用 它 。 在 那 之 
后 不 久 ， 该 公司 就 关门 大 吉 了 。 


20 年 后 ， 我 见 到 那 家 公司 的 一 位 早期 雇员 ， 问 
他 当年 发 生 了 什么 事 。 他 的 回答 叫 我 合 发 恐惧 起 


来 。 原 来 ， 当 时 他 们 赶 痢 推出 产品 ， 代 码 与 得 乱 七 
八 糟 。 特 性 越 加 越 多 ， 人 代码 也 越 来 越 烂 ， 最 后 再 也 
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UR Fe t CARS TAS RR A? 如 果 你 是 
位 有 点 儿 经 验 的 程序 员 ， 定 然 多 次 遇 到 过 这 类 困 
境 。 我 们 有 专用 来 形容 这 事 的 词 : 沼泽 
Cwading) 。 我 们 趟 过 代码 的 水 域 。 我 们 穿 过 灌木 
密布 、 瀑 布 暗 藏 的 沼泽 地 。 我 们 拼命 想 找到 出 路 ， 
期 望 有 点 什么 线索 能 局 发 我 们 到 底 发 生 了 什么 事 ; 
但 目光 所 及 ， 只 是 越 来 越 多 死 气 沉 沉 的 代码 。 


你 当然 曾 为 糟糕 的 代码 所 困扰 过 。 那 么 一 一 为 
什么 要 与 糟 糙 的 代码 呢 ? 


是 想 快 点 完成 吗 ? 是 要 赶 时 间 吗 ? 有 可 能 。 或 
许 你 觉得 目 己 要 干 好 所 需 的 时 间 不 够 ， 假 使 伦 时 间 
清理 代码 ， 老 板 就 会 大 发 雷 仁 。 或 许 你 只 是 不 耐烦 
再 摘 这 和 套 程序 ， 期 望 早点 结束 。 或 许 你 看 了 看 上 自己 
承 诡 要 做 的 其 他 事 ， 意 识 到 得 赶紧 弄 完 手 上 的 东 
西 ， 好 接着 做 下 一 件 工作 。 这 种 事 我 们 部 干 过 。 


我 们 都 曾经 盯 一 眼 自 己 杀 手 造 成 的 混乱 ， 决 定 
弃 之 而 不 顾 ， 走 疝 新 一 天 。 我 们 都 曾经 看 到 上 自己 的 
烂 程序 大 然 能 运行 ， 然 后 断言 能 运行 的 烂 程序 总 比 









































什么 都 没有 强 。 我 们 都 曾经 说 过 有 于 一 日 再 回头 清 
理 。 当 然 ， 在 那些 日 子 里 ， 我 们 都 没 听 过 勒 布 明 
(LeBlanc) 法 则 : 稍 后 等 于 永 不 (Later equals 
never) 。 


1.3 混乱 的 代价 


只 要 你 干 过 两 三 年 编程 ， 就 有 可 能 曾 被 某 人 的 
炉料 的 代码 绊 倒 过 。 如 果 你 编程 不 止 两 三 年 ， 也 有 
可 能 被 这 种 代码 拖 过 后 腿 。 进 度 延 组 的 程度 会 很 严 
重 。 有 些 团队 在 项 目 初 期 进展 迅速 ， 但 有 那么 一 两 
年 的 时 间 却 慢 如 蜗 行 。 对 代码 的 每 次 修改 都 影响 到 
其 他 两 三 处 代码 。 修 改 无 小 事 。 每 次 添加 或 修改 代 
码 ， 痢 得 对 那 堆 扭 纹 柴 了 然 于 心 ， 这 样 才 能 往 上 扰 
更 多 的 扭 纹 荣 。 这 团 乱 采 越 来 越 大 ， 再 也 无 法 理 
i> BUR RFA 
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HTE. SEPH TEN, SHRIKA AAF 
做 了 : 增加 更 多 人 手 到 项 目 中 ， 期 望 提 升 生 产 力 。 
ALERT ASFA ARI ea AS EIT A 
样 的 修改 符合 设计 意图 ， 什 么 样 的 修改 违背 设计 意 
图 。 而 且 ， 他 们 以 及 团队 中 的 其 他 人 痢 背 人 负 看 所 升 
生产 力 的 可 怕 压 力 。 于 是 ， 他 们 制造 更 多 的 混乱 ， 
驱动 生产 力 回 零 那 问 不断 下 降 。 如 图 1-1 所 示 。 


























时 间 
图 1-1 生产 力 vs. 时 间 


1.3.1 华丽 新 设计 


最 后 ， 开 发 团队 造反 了 ， 他 们 告诉 管理 层 ， 表 
也 无 法 在 这 令 人 生 厌 的 代码 基础 上 做 开发 。 他 们 要 
求 做 全 新 的 设计 。 管 理 层 不 愿意 投入 资源 完全 重 局 
炉灶 ， 但 他 们 也 不 能 人 否认 生产 力 低 得 可 怕 。 他 们 只 
好 同意 开 及 者 的 要 求 ， 授 权 去 做 一 套 看 上 去 很 美的 
华丽 新 设计 。 


于 是 束 组 建 了 一 文 新 车 。 谁 部 想 加 入 这 个 团 
队 ， 因 为 它 是 张 晶 纸 。 他 们 可 以 重新 来 过 ， 搞 出 上 
真正 深 完 的 东西 来 。 但 只 有 最 优秀 、 最 了 乳 明 的 家 伙 
被 选中 。 其 余人 等 则 继续 维护 现 有 系统 。 


现在 有 两 文 队伍 在 竞赛 了 。 新 团队 必须 搭建 一 
套 新 系统 ， 要 能 实现 旧 系 统 的 所 有 功能 。 另 外 ， 还 














得 跟 上 对 旧 系 统 的 持续 改动 。 在 新 系统 功能 足以 抗 
衡 旧 系 统 之 前 ， 管 理 层 不 会 将 换 岳 旧 系 统 。 


苋 赛 可 能 会 持续 极 长 时 间 。 我 就 见 过 延续 了 十 
年 之 久 的 。 到 了 完成 的 时 候 ， 新 团队 的 老成 员 早 已 
不 知 去 癌 ， 而 现 有 成 员 则 要 求 重 新 设计 一 套 新 系 
统 ， 因 为 这 套 系统 太 烂 了。 


假使 你 经 历 过 哪怕 是 一 小 段 我 谈 到 的 这 种 事 ， 
那么 你 一 定 知 道 ， 花 时 间 保 持 代 码 整 洁 不 但 有 关 效 
XE, MUHRÓETR. 











1.3.9 ASE 


你 是 否 遇 到 过 有 种 严重 到 要 伦 数 个 星期 来 做 本 
来 只 十 数 小 时 即 可 完成 的 事 的 混乱 状况 ?你 是 否 见 
过 本 来 只 需 做 一 行 修改 ， 结 果 却 涉及 上 百 个 模块 的 
情况 ?这 种 事 太 和 常见 了 。 


怎么 会 友 生 这 种 事 ? 为 什么 好 代码 会 这 么 快 束 
变质 成 粳 料 的 代码 ? 理由 多 得 很 。 我 们 抱怨 需求 变 
KEA SWART. RATER AAR, WAF 
Wiio RATE VAS FAB ES ERI ZEB POR AY 
用 户 、 没 用 的 营销 方式 和 那些 电话 消毒 剂 。 不 过 ， 
亲爱 的 呆 伯 特 (Dilbert) P, RIE AAZ D! 
。 我 们 太 不 专业 了 。 











AAA. AREA TEE SS Ne? XE 
道 不 天 需求 的 事 ? 难道 不 天 进度 的 事 ? 难道 不 天 那 
些 怨 经理 和 没 用 的 营 铀 手段 的 事 ? 难道 他 们 就 不 该 
TRAD? 














不 。 经 理 和 营销 人 员 指 望 从 我 们 这 里 得 到 必须 
的 信息 ， 然 后 才能 做 出 承诺 和 保证 ， 即 便 他 们 没 开 
口 酉 ， 我 们 也 不 该 者 于 告知 自己 的 想法 。 用 户 指望 
我 们 验证 需求 是 否 都 在 系统 中 实现 了 。 项 目 经 理 指 
望 我 们 遵守 进度 。 我 们 与 项 目的 规划 脱 不 了 干系 ， 
对 失败 负 有 极 大 的 责任 ， 特 别 是 当 失 败 与 糟糕 的 代 
公有 关 时 尤为 如 此 ! 


“且慢 ! ”你 说 。“ 不 昕 经 理 的 ， 我 就 会 被 炒 鲍 
鱼 。” 多 半 不 会 。 多 数 经 理想 要 知道 实情 ， 即 便 他 
们 看 起 来 不 喜欢 实情 。 多 数 经 理想 要 好 代码 ， 即 便 
他 们 总 是 痴 缠 于 进度 。 他 们 会 奋力 卫 护 进度 和 十 
AR. 那 是 他 们 该 干 的 。 你 则 当 以 同等 的 热情 卫 护 代 
码 。 


再 说 明白 些 ， 假 使 你 是 位 医生 ， 病 人 请 求 你 在 
给 他 做 手术 前 别 洗 手 ， 因 为 那 会 花 太 多 时 间 ， 你 会 
照办 吗 出 ?本 该 是 病人 说 了 算 ; 但 医生 却 绝对 应 
该 拒绝 遵从 。 为 什么 ? 因为 医生 比 病 人 更 了 解 疾病 
和 感染 的 风险 。 医 生 如 果 按 病人 说 的 办 ， 就 是 一 种 
不 专业 的 态度 (更 别 说 是 犯罪 了 ) 。 























同 理 ， 程 序 员 亲 从 不 了 解 混乱 风险 的 经 理 的 音 
愿 ， 也 是 不 专业 的 做 法 。 


1.3.3” 迷 题 


程序 员 面 临 痢 一 种 基础 价值 谜 题 。 有 那么 几 年 
经 验 的 开发 者 都 知道 ， 之 前 的 混乱 拖 了 目 己 的 后 
腿 。 但 开 友 者 们 背负 期 限 的 压力 ， 只 好 制造 混乱 。 
简 言 之 ， 他 们 没 花 时 间 证 目 己 做 得 更 快 ! 


真正 的 专业 人 士 明 白 ， 这 道 谜 题 的 第 二 部 分 说 
Hl. BASIL) T 赶 上 期 限 。 混 乱 只 会 立刻 
拖 慢 你 ， 叫 你 错过 期 限 。 赶 上 期 限 的 唯一 方法 一 一 
做 得 代 的 唯一 方 沪 就 是 始终 尽 可 能 保持 代码 整 


洁 。 
13.4 整洁 代码 的 艺术 


假设 你 相信 混乱 的 代码 是 祸首 ， 假 设 你 接受 做 
得 快 的 唯一 方法 是 保持 代码 整洁 的 说 法 ， 你 一 定 会 
自问 :“ 我 怎么 才能 写 出 整洁 的 代码 ? ”不 过 ， 如 果 
你 不 明白 整洁 对 代码 有 何 意义 ， 尝 试 去 写 整 洁 代 码 
WL Jc Pr im ! 
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道 一 幅 男 是 好 还 是 坏 。 但 能 分 辨 优 务 并 不 表示 懂得 





























绘画 。 能 分 辩 整 洁 代 码 和 须 脏 代码 ， 也 不 意味 看 会 
写 整 洁 代 码 ! 


SANS, me KEN) RI, FZ 
百 习 得 的 “ 整 涪 感 >。 这 种 “代码 感 ” 束 是 关键 所 在 。 
有 些 人 生 而 有 之 。 有 些 人 费 后 劲 才 能 得 到 。 它 不 仅 
让 我 们 看 到 代码 的 优 务 ， 还 予 我 们 以 们 戒 规 之 力 化 
务 为 优 的 攻略 。 


缺乏 “代码 感 * 的 程序 员 ， 看 混乱 是 混乱 ， 无 处 
看 于 。 有 “代码 感 ”的 程序 员 能 从 混乱 中 看 出 其 他 的 
可 能 与 变化 。“ 代 码 感 ”帮助 程序 员 选 出 最 好 的 方 
RK FI SIET R MAKITA, HERRE. 


HEZ FS BIET ER 
家 ， 他 能 用 一 系列 变换 把 一 块 和 白板 变 作 由 优雅 代码 
构成 的 系统 。 

1.3.5 ”什么 是 整洁 代码 


AZDIR, MAZDE. MARR H H 
了 一 些 非 常 知名 且 经 验 丰 富 的 程序 员 。 








Bjarne Stroustrup，C++ 语 言 发 明 者 ，C++ 
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了 当 ， 叫 缺陷 难以 隐藏: 尽量 减少 依赖 和 关系， 使 之 
便于 维护 ;依据 某 种 分 层 战略 完善 错误 处 理 代码 ; 
性 能 调 至 最 优 ， 和 省 得 引诱 别人 做 没 规矩 的 优化 ， 搞 
出 一 扒 混 乱 来 。 整 洁 的 代码 只 做 好 一 件 事 。 

Bjarne 用 了 “优雅 ”一 词 。 说 得 好 ! 我 MacBook 


上 的 词典 所 供 了 如 下 定义 : 外 表 或 举止 上 令 人 愉悦 
RAMIEN; ATA TB hg SCAT fi Eo 注意 





对 “愉悦 "一 词 的 强调 。Bjarne 显 然 认 为 整洁 的 代码 
读 起 来 令 人 愉悦 。 读 这 种 代码 ， 就 像 见 到 手工 精 
美的 音乐 盒 或 者 设计 精良 的 汽车 一 般 ， 让 你 会 心 一 


ae 





Bjarne 也 所 到 效率 一 一 而 且 两 次 提 及 。 这 话 出 
目 C++ 发 明 者 之 口 ， 或 许 并 不 出 奇 ， 不 过 我 认为 并 
非 是 在 单纯 退 求 速度 。 被 溪 费 抒 的 运算 周期 并 不 雅 
观 ， 并 不 令 人 愉悦 。 留 意 Bjarne 怎 么 描述 那 种 不 雅 
观 的 结果 。 他 用 了 “引诱 ?这 个 词 。 城 埠 斯 言 。 精 糕 
的 代码 引发 混乱 ! 别人 修改 粳 糙 的 代码 时 ， 往 往 
会 越 改 越 烂 。 


务实 的 Dave Thomas 和 Andy Hunt\ 5; — fA FE |] 
述 了 这 种 情况 。 他 们 提 到 破 窗 理论 Sl] 。 窗 户 破 损 
了 的 建筑 让 人 和 党 得 似乎 无 人 照管 。 于 是 别人 也 再 不 
关心 。 他 们 放任 窗户 继续 人 破损。 最 终 目 己 也 参加 破 
坏 活动 ， 在 外 才 上 涂鸦 ， 任 垃圾 堆积 。 一 面 破损 的 
BP A ee SA DE TA AY EL BR o 
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程序 员 忽视 细节 的 一 种 表现 。 此 外 还 有 内 存 泄 漏 ， 
还 有 竞 态 条 件 代 码 。 还 有 前 后 不 一 致 的 命名 方式 。 
结果 就 是 凸现 出 整洁 代码 对 细节 的 重视 。 














Bjarme 以 “整洁 的 代码 只 做 好 一 件 事 ”结束 论 
断 。 工 庸 置疑 ， 软 件 设 计 的 许多 原则 最 终 都 会 归结 
为 这 人 句 警 语 。 有 那么 多 人 发 表 过 类 似 的 言论 。 糟 料 
的 代码 想 做 太 多 事 ， 它 意图 混乱 、 目 的 含混 。 整 洁 
的 代码 力求 集中 。 每 个 函数 、 每 个 类 和 每 个 模块 都 
全 神 贯 注 于 一 事 ， 完 全 不 受 四 周 细节 的 干扰 和 污 
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Grady Booch, Object Oriented Analysis and 
Design with Applications 〈 中 译 版 《 面 问 对 象 分 析 
Eu aba. 


整洁 的 代码 简单 直接 。 整 洁 的 代码 如 同 优美 的 
散文 。 整 洁 的 代码 从 不 隐藏 设计 者 的 童 图， 充满 了 
干净 利落 的 抽象 和 直截了当 的 控制 语句 。 





Grady 的 观点 与 Bjarmne 的 观点 有 类 似 之 处 ， 但 他 
从 可 读 性 的 角度 来 定义 。 我 特别 喜欢 “整洁 的 代码 
如 同 优 美的 散文 * 这 种 看 法 。 想 想 你 读 过 的 菜 本 好 
书 。 回 忆 一 下 ， 那 些 文字 是 如 何在 脑 中 形成 影像 ! 
就 像 是 看 了 场 电 影 ， 对 吧 ? 还 不 止 ! 你 还 看 到 那些 
人 物 ， 听 到 那些 声音 ， 体 验 到 那些 喜人 经 不 乐 。 


阅读 整洁 的 代码 和 阅读 Lord of the Rings (AVE 
版 《指环 王 》) 目 然 不 同 。 不 过 ， 仍 有 可 类 比 之 
处 。 如 同一 本 好 的 小 说 般 ， 整 洁 的 代码 应 当 明 确 地 
展现 出 要 解决 问题 的 张力 。 它 应 当 将 这 种 张力 推 至 
高 湖 ， 以 某 种 显而易见 的 方案 解决 问题 和 张力 ， 使 
读者 发 出 “ 啊 哈 ! 本 当 如 此 ! ”的 感叹 。 


9i UL AGrady PriB TFR Wh Ae” Ccrisp 

abstraction) ， 力 是 绝妙 的 矛盾 修辞 法 。 毕 葛 crisp 
几乎 就 是 “具体 ”(concrete) 的 同义词 。 我 MacBook 
上 的 词典 这 样 定义 crisp 一 词 : 果断 决绝 ， 就 事 论 
事 ， 没 有 犹豫 或 不 必要 的 细节 。 尽管 有 两 种 不 同 
的 定义 ， 该 词 还 是 承载 了 有 力 的 信息 。 代 人 码 应 当 讲 
述 事 实 ， 不 引 人 猜 测 。 它 只 该 包含 必需 之 物 。 旋 者 
应 当 感 受到 我 们 的 果断 决绝 。 
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“老大 ”Dave Thomas，OTI 公 司 创 始 人 ， 
Eclipse 战略 教父 。 


整洁 的 代码 应 可 由 作者 之 外 的 开 肥 者 阅读 和 增 
和 补 。 它 应 当 有 单元 测试 和 验收 测试 。 它 使 用 有 意义 
的 命名 。 它 只 所 供 一 种 而 非 多 种 做 一 件 事 的 途径 。 
它 只 有 尽量 少 的 依赖 天 系 ， 而 且 要 明确 地 定义 和 所 
供 清 上 晰 、 尽 量 少 的 API。 代 码 应 通过 其 字面 表达 合 
义 ， 因 为 不 同 的 语言 导致 并 非 所 有 必需 信息 均 可 通 
过 代码 目 身 清晰 表达 。 


Dave 老 大 在 可 读 性 上 和 Grady 持 相同 观点 ， 但 























有 一 个 重要 的 不 同 之 处 。Dave 断 言 ， 整 洁 的 代码 便 
于 其 他 人 加 以 增补 。 这 看 似 显而易见 ， 但 亦 不 可 

过 分 强调 。 毕 竟 易 读 的 代码 和 易 修 改 的 代码 之 间 还 
是 有 区 别 的 。 


Dave 将 整洁 系 于 测试 之 上 ! 要 在 十 年 之 前 ， 这 
会 让 人 大 跌眼镜 。 但 测试 驱动 开发 《Test Driven 
Development) 已 在 行业 中 造成 了 深 远 影 响 ， 成 为 
基础 规程 之 一 。Dave 说 得 对 。 没 有 测试 的 代码 不 干 
六。 不 官 它 有 多 优雅 ， 不 管 有 多 可 读 、 多 吻 理 解 ， 
ACE MAS, HEATER Ay AD 


Dave 两 次 提 及 “尽量 少 ”。 显 然 ， 他 推 当 小 块 的 
a 实际 上 ， 从 有 软件 起 人 们 残 在 反复 强调 这 一 
Aio RB. 


Dave 也 提 到 ， 代 码 应 在 字面 上 表达 其 含 

一 观点 源 目 Knuth 的 “字面 编程 ”(〈jiterate 
programming) 【| 。 结 论 就 是 应 当 用 人 类 可 读 的 方 
AEST. 


























Michael Feathers， Working Effectively with 
Legacy Code 中 译 版 《修改 代码 的 艺术 》) 一 书 
作者 。 


我 可 以 列 出 我 留意 到 的 整洁 代码 的 所 有 特点 ， 
但 其 中 有 一 条 是 根本 性 的 。 整 洁 的 代码 总 是 看 起 来 
像 是 茶 位 特别 在 意 它 的 人 写 的 。 几 乎 没有 改进 的 余 
地 。 代 码 作者 什么 都 想到 了 ， 如 果 你 企图 改进 它 ， 
忆 会 回 到 原点 ， 赞 路 条 人 留 给 你 的 代码 一 一 全 心 投 
入 的 某 人 留 下 的 代码 。 








一 言 以 项 之 : 在意。 这 就 是 本 书 的 题 则 所 在 。 
或 许 该 加 个 副标题 ， 如 何在 意 代 人 码 。 
Michael| 一 针 见 血 。 整 洁 代 人 码 束 是 作者 着 力 照 


料 的 代码 。 有 人 曾 花 时 间 让 它 保持 简单 有 序 。 他 们 
适当 地 关注 到 了 细节 。 他 们 在 意 过 。 














Ron Jeffries, Extreme Programming Installed 
(中 译 版 《极限 编程 实施 》) 以 及 Extreme 
Programming Adventures in C# (P Efl (CHER BR. 
编程 探险 》) 作者 。 


Ron 初 入 行 就 在 战略 空军 司令 部 (Strategic Air 





Command) 编写 Fortran 程 序 ， 此 后 几乎 在 每 种 机 器 
上 编写 过 每 种 语言 的 代码 。 他 的 言论 值得 咀嚼 。 


近年 来 ， 我 开始 研究 贝克 的 简单 代码 规则 ， 差 
不 多 也 都 琢磨 透 了 。 简 单 代 码 ， 依 其 重要 顺序 : 


能 通过 所 有 测试 

没有 重复 代码 ; 

体现 系统 中 的 全 部 设计 理念 ; 

包括 尽量 少 的 实体 ， 比 如 类 、 方 法 、 函 数 等 。 


在 以 上 诸 项 中 ， 我 最 在 意 代 码 重复 。 如 来 同一 
段 代码 反复 出 现 ， 束 表示 茶 种 想法 未 在 代码 中 得 到 
民 好 的 体现 。 我 尽力 去 找 出 到 压 那 是 什么 ， 然 后 再 
尽力 更 清晰 地 表达 出 来 。 


在 我 看 来 ， 有 意义 的 命名 是 体现 表达 力 的 一 种 
方式 ， 我 往往 会 修改 好 几 次 才 会 是 下 名 字 来 。 信 助 
Eclipse 这 样 的 现代 编码 工具 ， 重 命名 代价 极 低 ， 所 
以 我 无 所 顾忌 。 然 而 ， 表 达 力 还 不 只 体现 在 命名 
上 。 我 也 会 检查 对 象 或 方法 是 否 想 做 的 事 太 多 。 如 
末 对 象 功 能 太 多 ， 最 好 是 切 分 为 两 个 或 多 个 对 象 。 
如 果 方 法 功能 太 多 ， 我 总 是 使 用 抽取 手段 (Extract 
Method) 重 构 乙 ， 从 而 得 到 一 个 能 较为 清晰 地 说 明 
目 身 功能 的 方法 ， 以 及 妇 外 数 个 说 明 如 何 实现 这 些 
功能 的 方法 。 























消除 重复 和 提高 表达 力 让 我 在 整洁 代码 方面 获 
巷 民 多 ， 只 要 铭记 这 两 点 ， 改 进 脏 代码 时 隐 会 大 有 
不 同 。 不 过 ， 我 时 常 关注 的 发 一 规则 就 不 太 好 解释 
To 


这 么 多 年 下 来 ， 我 友 现 所 有 程序 部 由 极为 相似 
TRAR. MUERES FERED. MEE 
员 记 录 数 据 库 还 是 名 - 值 对 哈 希 表 ， 或 者 东 类 条 目 
的 数组 ， 我 们 都 会 发 现 目 己 想 要 从 集合 中 找到 东 一 
特定 和 条目。 一旦 出 现 这 种 情况 ， 我 通常 会 把 实现 手 
段 封 疲 到 更 抽象 的 方法 或 类 中 。 这 样 做 好 处 多 多 。 


可 以 先 用 茶 种 简单 的 手段 ， 比 如 哈 希 表 来 实现 
这 一 功能 ， 由 于 对 搜索 功能 的 引用 指 癌 了 我 那个 小 
THA, WHERE TEAC, MEO FEC. RPE at 
既 能 快速 前 进 ， 又 能 为 未 来 的 修改 预 留 余地 。 


Fb, ARGH Hi Fe ER A “LEE 
生 的 事 ， 避 免 随 意 实 现 集合 行为 ， 因 为 我 真正 需要 
的 不 过 是 菏 种 简单 的 得 找 手 段 。 


减少 重复 代码 ， 提 高 表达 力 ， 捉 早 构 建 简单 抽 
象 。 这 就 是 我 写 整洁 代码 的 方法 。 

Ron SEMA MPMI SABE ADA FE 
个 要 重复 代码 ， 只 做 一 件 事 ， 表 达 力 ， 小 规模 抽 



































象 。 该 有 的 都 有 了 。 





Ward Cunningham, Wiki/z 447%, eXtreme 
Programming 极限 编程 》 的 创始 人 之 一 ， 
Smalltalk 语 言 和 面 癌 对 象 的 忠 想 领袖 。 所 有 在 意 
代码 者 的 教父 。 


OAR BED BE ABLE VRB OR, AMBLER 
涪 代 码 。 如 末代 码 让 编程 语言 看 起 来 像 是 专 为 解决 
AB eT ETE, BAY APR ASCH o 
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深 。 你 大 概 以 为 此 言 深 合 己 童 吧 。 青 走 近 点 看 看 。 


NE 深 合 己 意 ”。 你 最 近 一 次 看 到 深 合 己 意 的 
模块 是 什么 时 候 ? 模块 多 半 都 繁复 难 解 吧 ? 难道 没 
有 触犯 规则 吗 ? 你 不 是 也 曾 挣扎 着 想 抓 住 些 从 整个 
系统 中 散 洲 而 出 的 线索 ,编织 进 你 在 读 的 那个 模块 
H3? 你 最 近 一 次 谈 到 某 段 代码 、 并 且 如 同 对 Ward 的 
说 法 点 头 一 般 对 这 段 代 码 点 头 ， 是 什么 时 候 的 事 
d. 


Ward 期 望 你 不 会 为 整洁 代码 所 震惊 。 你 无 需 花 
太 多 力气 。 那 代码 就 是 深 合 你 意 。 它 明确 、 简 单 、 
有 力 。 每 个 模块 都 为 下 一 个 模块 做 好 准备 。 每 个 模 
块 痢 告 诉 你 下 一 个 模块 会 是 怎样 的 。 整 涪 的 程序 好 
到 你 根本 不 会 注意 到 它 。 设 计 者 把 它 做 得 像 一 切 其 
他 设计 般 简 单 。 


那 Ward 有 天 “ 寺 ” 的 说 法 又 如 何 呢 ? 我 们 都 曾 面 
临 语言 不 是 为 要 解决 的 问题 所 设计 的 困境 。 但 Ward 
的 说 法 又 把 球 踢 回 我 们 这 边 。 他 说 ， 深 于 的 代码 让 
编程 语言 像 是 专 为 解决 那个 问题 而 存在 ! 所 以 ， 
让 语言 变 得 简单 的 黄 任 吏 在 我 们 SU E! 当心 ， 


Te ee ACY | 是 程序 员 让 语言 显得 简单 。 























R CHUELAUBO 又 是 怎么 想 的 呢 ? 在 我 眼中 整 
涪 代 码 是 什么 样 的 ? 本 书 将 以 详细 到 吓 死人 的 程度 
告诉 你 ， 我 和 我 的 同道 对 整 河 代 码 的 看 法 。 我 们 会 
告诉 你 关于 整洁 变量 名 的 想法 ， 关 于 整洁 函数 的 想 
法 ， 关 于 整洁 类 的 想法 ， 如 此 等 每。 我 们 视 这 些 观 
RASA, ARAM AM BGK. HRMS. FE 
职业 生涯 的 这 个 阶段 ， 这 些 观点 确 属 当然 ， 也 是 我 
f TEE US AYE B o 





武术 家 从 不 认同 所 谓 最 好 的 武术 ， 也 不 认同 所 
谓 绝招 。 武 术 大 师 们 第 第 创建 目 己 的 流派 ， 聚 徒 而 
授 。 因 此 我 们 才 看 到 格雷 西 家 族 在 巴西 开创 并 传授 
的 格雷 西 柔 术 (Gracie Jiu Jistu) ， 看 到 奥 山 龙 峰 
(Okuyama Ryuho) 在 未 和 尔 开创 并 传授 的 八 光 流 科 
AX (Hakkoryu Jiu Jistu) ， 看 到 李小龙 (Bruce 
Lee) 在 美国 开创 并 传授 的 截 拳 道 (Jeet Kune 
Do) 。 


加 子 们 沉浸 于 创始 人 的 授 业 。 他 们 全 心 师 从 菜 
位 师 伟 ， 排 斥 其 他 师 传 。 脂 子 有 上 所 成 就 后 ， 可 以 转 
投 男 一 位 师傅 ， 扩 展 自己 的 知识 与 技能 。 有 些 弟子 
最 终 和 白人 炼 成 钢 ， 创 出 新 招数 ， 开 和 宗 立 派 。 


任何 门派 都 并 非 绝对 正确 。 不 过 ， 身 处 某 一 
门派 时 ， 我 们 总 以 其 所 传 之 技 为 善 。 归 根 结 底 ， 练 
习 八 光 流 柔 术 或 截 产道 ， 自 有 其 善 法 ， 但 这 并 不 能 
否定 其 他 门派 所 授 之 法 。 


可 以 把 本 书 看 作 是 对 象 导师 (Object Mentor) 
[整洁 代码 派 的 说 明 。 里 面 要 传授 的 就 是 我 们 勤 
操 已 艺 的 方法 。 如 果 你 避 从 这 些 教诲 ， 你 就 会 如 我 
们 一 般 乐 受 其 荔 ， 你 将 学 会 如 何 编号 整洁 而 专业 的 
代码 。 但 无 论 如 何 也 别 错 以 为 我 们 是 “正确 的 "。 其 
他 门派 和 师傅 和 我 们 一 样 专业 。 你 有 必要 也 同人 他们 


33. 


























实际 上 ， 书 中 很 多 建议 部 存在 争议。 或 许 你 并 
不 完全 同意 这 些 建议 。 你 可 能 会 强烈 反对 其 中 一 些 
建议 。 这 样 手 好 的 。 我 们 不 能 要 求 做 最 终 权 威 。 男 
外 一 方面 ， 书 中 列 出 的 建议 ， 乃 是 我 们 长 久 苗 思 、 
从 数 十 年 的 从 业经 验 和 无 数 坚 试 与 错误 中 得 来 。 无 
论 你 同意 与 否 ， 如 果 你 没 看 到 或 是 不 章 侣 我 们 的 观 
Bo BAAR ORR. 





1.5 ”我们 是 作者 

Javadoc 中 的 @author 字 段 告诉 我 们 上 自己 是 什么 
人 。 我 们 是 作者 。 作 者 都 有 读者 。 实 际 上 ， 作 者 有 
责任 与 读者 做 良好 沟通 。 下 次 你 写 代 码 的 时 候 ， 
记得 目 己 是 作者 ， 要 为 评判 你 工作 的 读者 写 代 码 。 


你 或 许 会 问 : 代码 真正 * 读 ”的 成 分 有 多 少 呢 ? 
难道 力量 主要 不 是 用 在 “ 写 ” 上 吗 ? 

你 是 否 玩 过 “编辑 器 回放 ”? 20 世 纪 80、90 年 
代 ，Emac 之 类 编辑 器 记录 每 次 击 键 动作 。 你 可 以 在 
一 小 时 工作 之 后 ， 回 放 击 键 过 程 ， 就 像 是 看 一 部 高 
速 电 影 。 我 这 么 做 过 ， 结 果 很 有 趣 。 


回放 过 程 显 示 ， 多 数 时 间 部 是 在 滚动 屏 秦 、 浏 
只 其 他 模块 ! 


fil ENRI 

他 辐 下 滚动 到 要 修改 的 函数 。 

他 停 下 来 考 碟 可 以 做 什么 。 

哦 ， 他 滚动 到 模块 项 端 ， 检 查 变 量 初始 化 。 





























现在 他 回 到 修改 处 ， 开 始 键入 。 
We, QU PSY EAKA. 

他 重新 键入 。 

他 又 删除 了 ! 

他 键入 了 一 半 什 么 东西 ， 叉 删除 挥 。 


他 深 动 到 调用 要 修改 函数 的 力 一 函数 ， 看 看 是 
怎么 调用 的 。 


他 回 到 修改 处 ， 重 新 键入 刚才 删 掉 的 代码 。 
他 停 下 来 。 
他 再 一 次 删 挥 代码 ! 


他 打开 另 一 个 窗口 ， 奏 看 别 的 子 类 。 那 是 个 复 
ER PK BUY ? 





你 该 明日 了 。 读 与 写 化 费时 间 的 比例 超过 
10:1。 写 新 代码 时 ， 我 们 一 直 在 读 旧 代码 。 





既然 比例 如 此 之 高 ， 我 们 就 想 让 读 的 过 程 变 得 
轻松 ， 即 便 那 会 使 得 编写 过 程 更 难 。 没 可 能 光 写 不 
恋 ， 所 以 使 之 易 读 实 际 也 使 之 易 写 。 


这 事 概 无 例外 。 不 读 周 边 代 码 的 话 就 没 法 写 代 
码 。 编 写 代 人 码 的 难度 ， 取 决 于 读 周 边 代 人 码 的 难度 。 
要 想 干 得 快 ， 要 想 早 扣 做 完 ， 要 想 轻 松 写 代码 ， 先 
让 代码 易 读 吧 。 





16 Zi TEX 


光 把 代码 写 好 可 不 够 。 必 须 时 时 保持 代码 整洁 
。 我 们 都 见 过 代码 随时 间 流 逝 而 腐 坏 。 我 们 应 当 更 
只 极地 阻止 腐 坏 的 发 生 。 


信用 美国 鞋子 苗 一 条 简单 的 车 规 ， 应 用 到 我 们 
的 专业 领域 : 


让 营地 比 你 来 时 更 干净 。 [8l 


如 果 每 次 签 入 时 ， 人 代码 都 比 签 出 时 干净 ， 那 么 
代码 就 不 会 腐 坏 。 清 理 并 不 一 定 要 花 多 少 功夫 ， 也 
许 只 是 改 好 一 个 变量 名 ， 拆 分 一 个 有 点 过 长 的 函 
数 ， 消 除 一 点 点 重复 代码 ， 清 理 一 个 髓 套 站 语句 。 


你 想 要 为 一 个 代码 随时 间 流 逝 而 越 变 越 好 的 项 
目 工作 吗 ? 你 还 能 相信 有 其 他 更 专业 的 做 法 吗 ? 难 
着 持续 改进 不 是 专业 性 的 内 在 组 成 部 分 吗 ? 











1.7 前 传 与 原则 
从 许多 角度 看 ， 本 书 都 是 我 2002 年 写 那 本 Agile 


Software Development: Principles, Patterns, and 

Practices 《中 译 版 《敏捷 软件 开发 : 原则 、 模 式 与 
实践 》， 人 简称 PPP) 的 “前 传 ”。PPP 关 注 面 癌 对象 设 
计 的 原则 ， 以 及 专业 开发 者 采用 的 许多 实践 方法 。 
假如 你 没 读 过 PPP， 你 会 发 现 它 像 这 本 书 的 延续 。 
etch eae 会 友 现 那 本 书 的 主张 在 代码 层面 于 本 
ù ca [a] Haj 。 


在 本 书 中 ， 你 会 友 现 对 不 同 设 计 原 则 的 引用 ， 
包括 单一 权 责 原则 (Single Responsibility 
Principle, SRP) 、 开 放 闭 合 原 则 (Open Closed 
Principle, OCP) 和 依赖 倒置 原则 (Dependency 
Inversion Principle, DIP) 等 。 














1.8 / LZ 


乞 术 书 并 不 保证 你 读 过 之 后 能 成 为 艺术 家 ， 只 
能 告诉 你 其 他 艺术 家 用 过 的 工具 、 技 术 和 思维 过 
程 。 本 书 同 样 也 不 担保 让 你 成 为 好 程序 员 。 它 不 担 
保 能 给 你 “代码 感 ”。 生 所 能 做 的 ， 只 是 展示 好 程序 
员 的 思维 过 程 ， 还 有 他 们 使 用 的 撤 巧 、 撤 术 和 工 


^ 
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和 艺术 书 一 样 ， 本 书 也 充满 了 细 市 。 代 码 会 很 
多 。 你 会 看 到 好 代码 ， 也 会 看 到 糟糕 的 代码 。 你 会 
看 到 糖 糕 的 代码 如 何 转化 为 好 代码 。 你 会 看 到 局 
发 、 规 条 和 技巧 的 列表 。 你 会 看 到 一 个 又 一 个 例 
子 。 但 最 终结 条 取决 于 你 目 己 。 


还 记得 那个 关于 小 提 芬 家 在 去 表演 的 路 上 迷路 
的 老 笑 话 吗 ? 他 在 街角 拦住 一 位 长 者 ， 问 他 怎么 才 
能 去 卡耐基 音乐 厅 (Carnegie Hall) 。 长 者 看 了 看 
小 提 生 家 ， 又 看 了 看 他 手中 的 苍 ， 说 道 : “你 还 得 
Zi FEF, WGA! ” 
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2. 介绍 


软件 中 随处 可 见 命 名 。 我 们 给 变量 、 函 数 、 参 
数 、 类 和 封包 命名 。 我 们 给 源 代 人 码 及 源 代 人 码 所 在 日 
录 命 名 。 我 们 给 jar 文 件 、war 文 件 和 ear 文 件 命 名 。 
我 们 命名 、 人 命名， 不 断 命 名 。 既 然 有 这 么 多 命名 要 
人 做， 不妨 做 好 它 。 下 文 列 出 了 取 个 好 名 字 的 几 条 人 简 
单 规则 。 





2.2 名副其实 


名 副 其 实说 起 来 蚀 单 。 我 们 想 要 强调 ， 这 事 很 
严肃 。 选 个 好 名 字 要 花 时 间 ， 但 省 下 来 的 时 间 比 
化 挥 的 多 。 注 章 命 名 ， 而 且 一 旦 发 现 有 更 好 的 名 
称 ， 就 换 挥 旧 的 。 这 么 做 ， 读 你 代码 的 人 【包括 你 
目 己 ) 都 会 更 开心 。 


变量 、 函 数 或 类 的 名 称 应 该 已 经 答复 了 所 有 的 
大 问题 。 它 该 告诉 你 ， 它 为 什么 会 存在 ， 它 做 什么 
事 ， 应 该 怎么 用 。 如 宋 名 称 需 要 注释 来 补 序 ， 那 束 

















不 算是 名 副 其 实 。 


int d; // 消逝 的 时 间 ， 以 日 计 





名 称 d 什 么 也 没 说 明 。 它 没有 引起 对 时 间 消逝 
的 感觉 ， 更 别 说 以 日 计 了 。 我 们 应 该 选择 指明 了 计 
量 对 象 和 计量 单位 的 名 称 : 











int elapsedTimeInDays; 
int daysSinceCreation; 
int daysSinceModification; 


int fileAgeInDays; 





选择 体现 本 意 的 名 称 能 让 人 更 容易 理解 和 修改 
代码 。 下 列 代 码 的 目的 何在 ? 


public List<int[]> getThem() { 
List<int[]> list1 = new ArrayList<int[]>(); 
for (int[] x : theList) 
if (x[0] == 4) 


listi.add(x); 
return list1; 





为 什么 难以 说 明 上 列 代码 要 做 什么 事 ? 里 面 并 
设 有 复杂 的 表达 却 。 空 格 和 缩 进 中 规 中 矩 。 只 用 到 
三 个 变量 和 两 个 当量。 甚至 没有 涉及 任何 其 他 类 或 
多 态 方法 ， 只 是 (或 者 看 起 来 是 ) 一 个 数组 的 列表 
而 已 。 


问题 不 在 于 代码 的 简 活 上 度 ， 而 是 在 于 代码 的 模 
WARE + 即 上 下 文 在 代码 中 未 被 明确 体现 的 程度 。 
上 列 代 人 码 要 求 我 们 了 解 类 似 以 下 问题 的 答案 : 

(1) theList 中 是 什么 类 型 的 东西 ? 
(2) theList 堆 下 标 条 目的 意义 是 什么 ? 
(3) 值 4 的 意义 是 什么 ? 


(4) 我 怎么 使 用 返回 的 列表 ? 




















问题 的 答案 没 体 现在 代码 段 中 ， 可 那 就 是 它们 
该 在 的 地 方 。 比 方 说 ， 我 们 在 开 友 一 种 扫雷 洲 
戏 ， 我 们 发 现 ， 盘 面 是 名 为 theList 的 单元 格 列表 ， 
那 束 将 其 名 称 改 为 gameBoard。 


盘面 上 每 个 单元 格 都 用 一 个 简单 数组 表示 。 我 
们 还 及 现 ， 零 下 标 条 目 是 一 种 状态 值 ， 而 该 种 状态 
值 为 4 表示 “已 标记 ”。 只 要 改 为 有 音义 的 名 称 ， 代 
人 码 束 会 得 到 相当 程度 的 改进 : 














public List<int[]> getFlaggedCells() { 
List<int[]> flaggedCells = new ArrayList<int[]>(); 
for (int[] cell : gameBoard) 
if (cell[STATUS_VALUE] == FLAGGED) 
flaggedCells.add(cell); 


return flaggedCells; 
} 





注意 ， 代 码 的 简洁 性 并 未 被 触及 。 运 算 和 从 和 总 
量 的 数量 全 然 保 持 不 变 ， 退 套数 量 也 全 然 保 持 不 
变 。 但 代码 变 得 明确 多 了 。 

还 可 以 更 进一步 ， 不 用 int 数 组 表示 单元 格 ， 而 
是 男 写 一 个 类 。 该 类 包括 一 个 名 副 其 实 的 函数 〈 称 
为 isFlagged) ， 从 而 掩盖 住 那 个 魔术 数 H. FÆ 
得 到 函数 的 新 版 本 : 


public List«Cell» getFlaggedCells() { 








List<Cell> flaggedCells = new ArrayList<Cell>(); 
for (Cell cell : gameBoard) 
if (cell.isFlagged() ) 
flaggedCells.add(cell); 
return flaggedCells; 
} 





REMEN PAR, WERE Dy AI AE TI 





么 。 这 束 古 选用 好 名 称 的 力量 。 


2.3. ”避免 误导 


程序 员 必 须 避 人 免 留 下 掩藏 代码 本 意 的 错误 线 
索 。 应 当 避 人 免 使 用 与 本 意 相 屠 的 词 。 例 如 ，hp、aix 
和 sco 性 不 该 用 做 变量 名 ， 因 为 它们 都 是 UNIX 平 台 
或 类 UNIX 平 台 的 专 有 名 称 。 即 便 你 是 在 编写 三 角 
计算 程序 ，hp 看 起 来 是 个 不 错 的 缩写 Ul, (HEU 


可 能 会 近 供 错误 信息 。 


别 用 accountList 来 指称 一 组 账号 ， 除 非 它 真 的 
是 List 类 型 。List 一 词 对 程序 员 有 特殊 意义 。 如 果 包 
纳 账 号 的 容器 并 非 真 是 个 List， 就 会 引起 错误 的 判 
Wr B] 。 所 以 ， 用 accountGroup 或 


bunchOfAccounts， 甚 至 直接 用 accounts 都 会 好 一 
final 


一 一 
—a 














提防 使 用 不 同 之 处 较 小 的 名 称 。 想 区 分 模块 中 
某 处 的 XYZControllerFor EfficientHandlingOfStrings 
和 为 一 处 的 
XYZControllerForEfficientStorageOfStrings， 会 花 多 


长 时 间 呢 ?这 两 个 词 外 形 实在 太 相 似 了 。 


以 同样 的 方式 拼写 出 同样 的 概念 才 是 信息 。 拼 
*3 Bl Je A^ — BOSE VR SE 。 我 们 很 时 有 党 现代 Java 编 程 


环境 的 自动 代码 完成 特性 。 键 入 某 个 名 称 的 前 几 个 
FRE, fe PATRAS CURA). WAE 
得 到 一 列 该 名 称 的 可 能 形 云 。 假 如 相似 的 名 称 依 字 
母 顺序 放 在 一 起 ， 且 差异 很 明 吕 ， 那 就 会 相当 有 助 
蔓 ， 因 为 程序 员 多 半 会 压根 不 看 你 的 详细 注释 ， 其 
至 不 看 该 类 的 方法 列表 就 且 接 看 名 字 挑 一 个 对 象 。 


误导 性 名 称 真正 可 怕 的 例子 ， 是 用 小 写字 母 ] 
和 大 写字 母 O0 作 为 变量 名 ， 尤 其 是 在 组 合 使 用 的 时 
候 。 当 然 ， 问 题 在 于 它们 看 起 来 完全 像 是 前 
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读者 可 能 会 认为 这 纯 属 虚构 ， 但 我 们 确 曾 见 过 
充斥 这 闫 玩意 的 代码 。 有 一 次 ， 代 码 作者 建议 用 不 








同和 字体 写 变 量 名 ， 好 显得 更 清楚 些 ， 不 过 这 种 方案 
得 要 通过 口头 和 书面 传递 给 未 来 所 有 的 开发 者 才 
fr. JAK, RERI ARREDARE, WIER 了 
问题 ， 而 且 也 没 摘出 别 的 事 。 








2.4 做 有 意义 的 区 分 


T AR REF Va IH Xe JS AE Zn VE ni ERR AE rs HE] ri 2 
WR, Meher. pun. KA E — EHR i 
围 内 两 样 不 同 的 东西 不 能 重 名 ， 你 可 能 会 随手 改 把 
其 中 一 个 的 名 称 。 有 时 干脆 以 错误 的 拼写 序数 ， 结 
果 就 是 出 现在 更 正 拼 写 错误 后 导致 编 译 右 出 错 的 情 
i. M 








光 是 添加 数字 系列 或 是 废话 远 远 不 够 ， 即 便 这 
中 以 让 编译 砷 满意 。 如 来 名 称 必须 相 异 ， 那 其 意思 
也 应 该 不 同 才 对 。 


以 数字 系列 命名 Cal, a2, ...... aN) 是 依 义 命 
名 的 对 立 面 。 这 样 的 名 称 纯 属 误导 一 一 完全 没有 提 
供 正确 信息 ; 没有 提供 导 问 作者 意图 的 线索 。 试 
看 : 





public static void copyChars(char ai[], char a2[]) { 
for (int i = 0; i < a1.length; i++) { 


a2[i] = a1[i]; 





如 果 参 数 名 改 为 Source 和 destination， 这 个 函数 
束 会 像样 许多 。 


废话 是 男 一 种 没 意 义 的 区 分 。 假 设 你 有 一 个 
Product 类 。 如 果 还 有 一 个 ProductInfo 或 ProductData 
类 ， 那 它们 的 名 称 虽 然 不 同 ， 意 思 却 无 区 别 。Info 
和 Data 束 像 4a、an 和 和 the 一样 ， 是 意义 含混 的 废话 。 


注意 ， 只 要 体现 出 有 意义 的 区 分 ， 使 用 a 和 the 
这 样 的 前 级 就 没 错 。 例 如 ， 你 可 能 把 a 用 在 域内 变 
量 ， 而 把 the 用 于 函数 参数 I。 但 如 果 你 已 经 有 一 
个 名 为 zork 的 变量 ， 叉 想 调用 一 个 名 为 theZork 的 变 
E, MRK T- 


废话 都 是 宛 余 。Variable 一 词 永远 不 应 当 出 现 
在 变量 名 中 。Table 一 词 永远 不 应 当 出 现在 表 名 中 。 














NameString 会 比 Name 好 吗 ? 难道 Name 会 是 一 个 译 
点 数 不 成 ? WORE, LAIR SORT RS RIAN 
则 。 设 想 有 个 名 为 Customer 的 类 ， 还 有 一 个 名 为 
CustomerObject 的 类 。 区 别 何在 呢 ?” 哪 一 个 是 表示 
客户 历史 文 付 情况 的 最 佳 途 径 ? 


有 个 应 用 反映 了 这 种 状况 。 为 当事者 讳 ， 我 们 
改 了 一 下 ， 不 过 犯错 的 代码 的 确 就 是 这 个 样子 : 











getActiveAccount(); 
getActiveAccounts(); 


getActiveAccountInfo(); 





程序 员 怎 么 能 知道 该 调用 哪个 函数 呢 ? 


如 果 人 缺少 明确 约定 ， 变 量 moneyAmount 瓯 与 
money [X51], customerInfo 5E; customer? [X i], 
accountData 5 account? [X 3], theMessagets 5 
messagey X Fil], BX 4rd. MLCT Be SR 
不 同 之 处 的 方式 来 区 分 。 


25 ”使 用 读 得 出 来 的 名 称 


人 类 长 于 记忆 和 使 用 单词 。 大 脑 的 相当 一 部 分 
就 是 用 来 容纳 和 处 理 单词 的 。 单 词 能 读 得 出 来 。 人 
类 进化 到 大 脑 中 有 那么 大 的 一 块 地 方 用 来 处 理 言 
语 ， 寿 不 但 加 利用 ， 实 在 是 种 耻辱 。 


WR ARIE ER, PII 
Ep, AL, KIL, fp] = SIA Chee cee arr three 
cee enn tee). [S] E 3E, APERIRE (pee ess 
zee kyew) Ul Uc, E UE? ”这 不 是 小 事 ， 因 为 
编程 本 就 古 一 种 社会 活动 。 


有 家 公司 ， 程 序 里 面 写 了 个 genymdhms〈 生 成 
日 期 年、 月 、 日 、 时 、 分 、 秒 〉， 他 们 一 般 读 
作 “gen why emm dee aich emm ess" [91 。 我 有 个 见 字 
照 读 的 恶习 ， 于 是 开口 束 仿 “gen-yah-mudda- 
hims”。 后 来 好 些 设计 师 和 分 析 师 都 有 样 学 样 ， 听 
起 来 傻乎乎 的 。 我 们 知道 典故 ， 所 以 会 觉得 很 搞 
Ro ARIER, KEERAMA. EA 
TT AC AE Ee ON, did EE RFF 
的 自 造 词 ， 而 非 恰当 的 英语 词 。 比 较 


class DtaRcrd102 { 
private Date genymdhms; 



































private Date modymdhms; 
private final String pszqint = "102"; 
fo ass CO 

3 





和 


class Customer { 
private Date generationTimestamp; 
private Date modificationTimestamp;; 
private final String recordId = "102"; 


/* .., */ 
}; 





SLE eK at RA tah S: "UR, Mikey, FAIX 
条 记录 ! EREE (generation timestamp)?! 被 
设置 为 明天 了 1! 不 能 这 样 吧 ? ” 





2.6 ”使 用 可 搜索 的 名 称 


单字 母 名 称 和 数字 篆 量 有 个 问题 ， 束 是 很 难 在 
一 大 篇 文字 中 找 出 来 。 


JEMAX CLASSES PER _STUDENT 很 容易 ， 
但 想 找 数字 7 就 厂 烦 了 ， 它 可 能 是 某 些 文件 名 或 其 
他 常量 定义 的 一 部 分 ， 出 现在 因 不 同意 图 而 采用 的 
各 种 表达 式 中 。 如 果 该 常量 是 个 长 数字 ， 又 被 人 错 
改过 ， 就 会 逃 过 搜索 ， 从 而 造成 错误 。 


同样 ，e 也 不 是 个 便于 搜索 的 好 变量 名 。 它 是 
英文 中 最 音 用 的 字母 ， 在 每 个 程序 、 每 段 代 码 中 都 
有 可 能 出 现 。 由 此 而 见 ， 长 名 称 胜 于 短 名 称 ， 搜 得 
到 的 名 称 胜 于 用 目 造 编码 代 写 就 的 名 称 。 


鳃 以 为 单字 母 名 称 仅 用 于 短 方法 中 的 本 地 变 
量 。 名 称 长 短 应 与 其 作用 域 大 小 相对 应 [NS]. AE 
变量 或 常量 可 能 在 代码 中 多 处 使 用 ， 则 应 赋 其 以 便 
于 搜索 的 名 称 。 再 比较 






































for (int j-0; j«34; j++) { 
s += (t[j]*4)/5; 





和 


int realDaysPerIdealDay = 4; 
const int WORK DAYS PER WEEK - 5; 
int sum - 0; 
for (int j=0; j < NUMBER OF TASKS; j++) ( 
int realTaskDays - taskEstimate[j] * realDaysPerIdealDay; 





int realTaskWeeks - (realdays / WORK DAYS PER WEEK); 
sum += realTaskWeeks; 


J 








注意 ， 上 面 代码 中 的 sum 并 非特 别 有 用 的 名 
称 ， 不 过 它 至 少 搜 得 到 。 采 用 能 表达 意图 的 名 称 ， 
貌似 拉 长 了 函数 代码 ， 但 要 想 想 看 ， 
WORK. DAYS PER_WEEK 要 比 数字 5 好 找 得 多 ， 
而 列表 中 也 只 剩 下 了 体现 作者 意图 的 名 称 。 


2.7. ”避免 使 用 编码 


编码 已 经 太 多 ， 无 谓 表 日 找 肤 焕 。 把 类 型 或 作 
用 域 编 进 名 称 里 面 ， 徒 然 增 加 了 解码 的 负担 。 没 理 
由 要 求 每 位 新 人 都 在 弄 清 要 应 付 的 代码 之 外 《〈 那 算 
EESK) ， 还 要 再 摘 情 另 一 种 编码 “语言 "。 这 对 
于 解决 问题 而 言 ， 纯 属 多余 的 负担 。 带 编码 的 名 称 
AER, AAT te 


2.7.1 人 匈牙利 语 标 记 法 


在 往昔 名 称 长 短 很 要 命 的 时 代 ， 我 们 坚 无 必要 
地 破坏 了 不 编码 的 规矩 ， 如 今后 悔 不 失 。EFortran 语 
言 要 求 首 字母 体现 出 类 型 ， 导 致 了 编码 的 产生 。 
BASIC 早 期 版 本 只 允许 使 用 一 个 字母 再 加 上 一 位 数 
字 。 匈 牙 利 语 标记 法 (Hungarian Notation, HN) 
将 这 种 态势 合演 愈 烈 。 

















在 Windows 的 C 语 言 API 的 时 代 ，HN 相 当 重 
要 ， 那 时 所 有 名 称 要 么 是 个 整数 句柄 ， 要 么 是 个 长 
指针 或 者 void 指针 ， 要 不 然 就 是 string 的 儿 种 实现 
(有 不 同 的 用 途 和 属性 ) 之 一 。 那 时 候 编译 器 并 不 
做 类 型 检查 ， 程 序 员 需要 匈牙利 语 标记 法 来 帮助 上 自 
己 记 住 类 型 。 














现代 编程 语言 具有 更 丰 宇 的 类 型 系统 ， 编 诺 需 
也 记得 并 强制 使 用 类 型 。 而 且 ， 人 们 趋向 于 使 用 更 
小 的 类 、 更 短 的 方法 ， 好 让 每 个 变量 的 定义 都 在 视 
FYFE ZA 


Java 程 序 员 不 需要 类 型 编码 。 对 象 是 强 类 型 
的 ， 代 码 编辑 环境 已 经 先进 到 在 编译 开始 前 融 侦 训 
到 类 型 错误 的 程度 ! 所 以 ， 如 今 HN 和 其 他 类 型 编 
码 形式 部 纯 属 多 余 。 它 们 增加 了 修改 变量 、 函 数 或 
类 的 名 称 或 类 型 的 难度 。 它 们 增加 了 阅读 代码 的 难 
度 。 它 们 制造 了 让 编码 系统 误导 读者 的 可 能 性 。 











PhoneNumber phoneString; 


// ”类 型 变化 时 ， 名 称 并 不 变化 ! 





2.7.2 JA BU ZR 


也 不 必用 m_ 前 绥 来 标明 成 员 变 量 。 应 当 把 类 
和 函数 做 得 足够 小 ， 消 除 对 成 员 前 绥 的 需要 。 你 应 
当 使 用 东 种 可 以 高 完 或 用 颜色 你 出 成 员 的 编辑 环 


Kio 








public class Part { 
private String m_dsc; // The textual description 
void setName(String name) { 
m_dsc = name; 
} 
} 


public class Part ( 
String description; 
void setDescription(String description) { 
this.description - description; 





此 外 ， 和 人 们 会 很 快 学 会 无 视 前 级 (或 后 级 ) ， 
只 看 到 名 称 中 有 意义 的 部 分 。 代 码 读 得 越 多 ， 眼 中 








束 越 没有 前 级 。 最 终 ， 前 级 变 作 了 不 入 法 眼 的 废 
料 ， 变 作 了 旧 代 码 的 标志 物 。 


2.7.3 ”接口 和 实现 


有 时 也 会 出 现 采 用 编码 的 特殊 情形 。 比 如 ， 你 
在 做 一 个 创建 形状 用 的 抽象 工厂 (Abstract 
Factory) 。 该 工厂 是 个 接口 ， 要 用 有 具体 类 来 实现 。 
你 怎么 来 命名 工厂 和 具体 类 呢 ?IShapeFactory 和 和 
ShapeFactory 吗 ? 我 言 欢 不 加 修饰 的 接口 。 前 导 字 
母 I 被 得 用 到 了 说 好 听 点 是 和 干扰， 说 难听 点 根本 就 
是 废话 的 程度 。 我 不 想 让 用 户 知道 我 给 他 们 的 是 接 
口 。 我 束 想 让 他 们 知道 那 是 个 ShapeFactory。 如 果 
接口 和 实现 必须 选 一 个 来 编码 的 话 ， 我 村 此 选择 实 
现 。ShapeFactoryImp， 甚 至 是 丑陋 的 
CShapeFactory， 都 比 对 接口 名 称 编码 来 得 好 。 

















2.8 避免 思维 映射 


不 应 当 让 读者 在 脑 中 把 你 的 名 称 翻 译 为 他 们 熟 
知 的 名 称 。 这 种 问题 经 笛 出 现在 选择 是 使 用 问题 领 
域 术 语 还 是 解决 方案 领域 术语 时 。 


单字 母 变 量 名 束 是 个 问题 。 在 作用 域 较 小 、 也 
没有 名 称 冲突 时 ， 人 循环 计数 强 目 然 有 可 能 被 命名 为 i 
或 ] 或 Kk。 但 和 干 万 别 用 字母 1! ) 这 是 因为 传统 上 个 
用 单字 母 名 称 做 循环 计数 硕 。 然 而 ， 在 多 数 其 他 情 
况 下 ， 单 字母 名 称 不 是 个 好 选择 ; 读者 必须 在 脑 中 
将 它 映射 为 真实 概念 。 仅 仅 是 因为 有 了 a 和 b， 束 要 
取 名 为 c， 实 在 并 非 像 样 的 理由 。 


程序 员 通 常 都 是 聪明 人 。 聪 明 人 有 时 会 借 脑 筋 
急 转 弯 炫 次 其 聪明 。 总 而 言 之 ， 假 使 你 记得 r 代 表 
不 包含 主机 名 和 图 式 (scheme) 的 小 写字 母 版 ufl 的 
话 ， 那 你 真是 太 聪 明了 。 


聪明 程序 员 和 专业 程序 员 之 间 的 区 别 在 于 ， 专 
业 程序 员 了 解 ， 明 确 是 王道 。 专 业 程序 员 善 用 其 
能 ， 编 写 其 他 人 能 理解 的 代码 。 



































29 ”类 名 


类 名 和 对 象 名 应 该 是 名 词 或 名 词 短 语 ， 如 
Customer. WikiPage. Account#lAddressParser. 3 
免 使 用 Manager、Processor、Data 或 Info 这 样 的 类 
名 。 类 名 不 应 当 是 动词 。 





2.10 ”方法 名 


方法 名 应 当 是 动词 或 动词 短语 ， 如 
postPayment、deletePage 或 saave。 属 性 访问 器 、 修 改 
器 和 断言 应 该 根据 其 值 命 名 ， 并 依 Javabean 标 准 U0! 
加 上 get、set 和 is 前 绥 。 


string name = employee.getName(); 
customer.setName("mike"); 
if (paycheck.isPosted())... 





重 载 构造 器 时 ， 使 用 描述 了 参数 的 静态 工矿 方 
法 名 。 例 如 ， 


Complex fulcrumPoint = Complex.FromRealNumber(23.0); 


XE E HET 


Complex fulcrumPoint - new Complex(23.0); 


可 以 考虑 将 相应 的 构造 器 设置 为 private， 强 制 
使 用 这 种 命名 手段 。 


2.11 列 扮 可 爱 


JR AAPA BER, ADIRE IRIE SCR. VASA 
感 的 人 才能 记得 住 ， 而 且 还 是 在 他 们 记得 那个 笑话 
的 时 候 才 行 。 谁 会 知道 名 为 HolyHandGrenade HH 
的 函数 是 用 来 做 什么 的 呢 ? 没 错 ， 这 名 字 挺 伶俐 ， 
不 过 Deleteltems H 或 许 是 更 好 的 名 称 。 宁 可 明 
ffi, SPARE. 





扮 可 爱 的 做 法 在 代码 中 经 常 体现 为 使 用 俗话 或 
倡 语 。 例 如 ， 别 用 whack() H! 来 表示 kill( )。 别 用 
eatMyShorts( ) H4 这 类 与 文化 紧密 相关 的 笑话 来 表 
7Nabort( )。 


言 到 意 到 。 意 到 言 到 。 


2.12 ”每 个 概念 对 应 一 个 词 


给 每 个 抽象 概念 选 一 个 词 ， 并 且 一 以 贯 之 。 例 
如 ， 使 用 fetch、retrieve 和 get 来 给 在 多 个 类 中 的 同 种 
方法 命名 。 你 怎么 记得 住 哪个 类 中 是 哪个 方法 呢 ? 
很 塌 政 ， 你 总 得 记 住 编写 库 或 类 的 公司 、 机 构 或 个 
人 ， 才 能 想 得 起 来 用 的 是 哪个 术语 。 人 否则 ， 融 得 耗 
BEATEN TAD DEA PC EK AZ TS FCS - 


Eclipse 和 IntelliJ 之 类 现代 编程 环境 提供 了 与 环 
境 相 关 的 线索 ， 比 如 某 个 对 象 能 调用 的 方法 列表 。 
不 过 要 注意 ， 列 表 中 通 常 不 会 给 出 你 为 函数 名 和 参 
数列 表 编 写 的 注释 。 如 果 参 数 名 称 来 自 函 数 声明 ， 
你 束 太 幸运 了 。 函 数 名 称 应 当 独 一 无 二 ， 而 且 要 保 
DL EUR Be A fet HUI & R HII kG EI LE 8 
Js 


同样 ， 在 同一 堆 代 码 中 有 controller， 又 有 
manager, driver, WZS AB. 
DeviceManager 和 Protocol-Controller 之 间 有 何 根 本 区 
别 ? 为 什么 不 全 用 controllers 或 managers? 他 们 都 是 
Drivers 吗 ? 这 种 名 称 ， 让 人 和 觉得 这 两 个 对 象 是 不 同 
类 型 的 ， 也 分 属 不 同 的 类 。 


对 于 那些 会 用 到 你 代码 的 程序 员 ， 一 以 贯 之 的 























命名 法 简 百 就 是 天 降 福 首 。 


2.443 FIFA KR 


避 倪 将 同一 里 词 用 于 不 同 目的 。 同 一 术语 用 于 
不 同 概念 ， 基 本 上 就 是 双关 语 了。 如 果 遵 循 “ 一 词 
一 义 ” 规 则 ， 可 能 在 好 多 个 类 里 面 剖 会 有 add 方 法 。 
只 要 这 些 add 方 法 的 参数 列表 和 返回 值 在 语义 上 等 
价 ， 束 一 切 顺利 。 


但 是 ， 可 能 会 有 人 决定 为 “保持 一 致 > 而 使 用 
add 这 个 词 来 命名 ， 即 便 并 非 真 的 想 表 示 这 种 意 
思 。 比 如 ， 在 多 个 类 中 都 有 add 方 法 ， 该 方法 通过 
增加 或 连接 两 个 现存 值 来 获得 新 值 。 假 设 要 写 个 新 
类 ， 该 类 中 有 一 个 方法 ， 把 单个 参数 放 到 群集 
(collection) 中。 该 把 这 个 方法 叫做 add 吗 ?这样 
做 貌似 和 其 他 add 方 法 保持 了 一 人 改 ， 但 实际 上 语义 
却 不 同 ， 应 该 用 insert 或 append 之 类 词 来 命名 才 对 。 
把 该 方法 命名 为 add， 就 是 双关 语 了 。 


代码 作者 应 尽力 写 出 易于 理解 的 代码 。 我 们 想 
把 代码 写 得 让 别人 能 一 目 尽 帘 ， 而 不 必 婵 精 竭 虑 地 
研究 。 我 们 想 要 那 种 大 众 化 的 作者 尽 员 写 清楚 的 平 
eT; 我 们 不 想 要 那 种 学 者 挖 地 三 尺 才能 明日 
个 中 意义 的 学 院 派 模式 。 
































244 ”使 用 解决 方案 领域 名 称 


记 住 ， 只 有 程序 员 才 会 读 你 的 代码 。 所 以 ， 尽 
管用 那些 计算 机 科学 (Computer Science，CS) 术 
语 、 算 法 名 、 模 式 名 、 数 学 术语 吧 。 依 据 问题 所 涉 
领域 来 命名 可 不 算是 聪明 的 做 法 ， 因 为 不 该 让 协作 
者 老 是 跑 去 问 客户 每 个 名 称 的 合 义 ， 其 实 他 们 早 议 
通过 另 一 名 称 了 解 这 个 概念 了 。 








对 于 熟悉 访问 者 CVISITOR) 模式 的 程序 来 
说 ， 名 称 AccountVisitor 定 有 意义 。 哪 个 程序 员 会 不 
知道 JobQueue 的 意思 呢 ? 程序 员 要 做 太 多 技术 性 工 
E 
YZ e 





245 ”使 用 产 目 所 涉 问 题 钢 域 的 名 
称 


如 末 不 能 用 程序 员 熟 悉 的 术语 来 给 手头 的 工作 
命名 ， 束 采用 从 所 涉 问 题 领域 而 来 的 名 称 吧 。 人 至 
少 ， 有 负责 维护 代码 的 程序 员 融 能 去 请 教 领域 专家 
Je 


优秀 的 程序 员 和 设计 师 ， 其 工作 之 一 就 是 分 离 
解决 方案 领域 和 问题 领域 的 概念 。 与 所 涉 问 题 领 域 
更 为 贴近 的 代码 ， 应 当 采 用 源 目 问题 领域 的 名 称 。 








2.16 ”添加 有 意义 的 语 境 


很 少 有 名 称 是 能 目 我 说 明 的 一 一 多 数 部 不 能 。 
反之， 你 需要 用 有 民 好 命名 的 类 、 函 数 或 名 称 空间 
来 放置 名 称 ， 给 读者 提供 语 境 。 如 末 没 这 么 做 ， 给 
名 称 添加 前 级 束 是 最 后 一 招 了 。 














设想 你 有 和 名 为 firstrName、lastName、 street, 
houseNumber、city、state 和 zipcode 的 变量 。 当 它们 
搁 一 块 儿 的 时 候 ， 很 明确 是 构成 了 一 个 地 址 。 不 
过 ， 假 使 只 是 在 某 个 方法 中 看 见 扳 和 零 堆 一 个 state 弯 
EW? 你 会 理所当然 推 呆 那 是 某 个 地 址 的 一 部 分 
ni 2 





可 以 添加 前 级 addrFirstName、addrLastName、 
addrState 等 ， 以 此 提供 语 境 。 至 少 ， 读 者 会 明日 这 
些 变 量 是 某 个 更 大 结构 的 一 部 分 。 当 然 ， 更 好 的 方 
案 是 创建 名 为 Address 的 类 。 这 样 ， 即 便 是 编译 器 也 
会 知道 这 些 变量 隶 属 某 个 更 大 的 概念 了 。 


看 看 代码 清单 2-1 中 的 方法 。 以 下 变量 是 个 需 
要 更 有 意义 的 语 境 呢 ? 函数 名 仅 给 出 了 部 分 语 境 ; 
Age SR PAB. Wie Ba, PKS AE 
number、verb 和 pluralModifier 这 三 个 变量 是 “ 测 
估 ” 信 息 的 一 部 分 。 不 外 的 是 这 语 境 得 靠 读 者 推 师 





























出 来 。 第 一 眼看 到 这 个 方法 时 ， 这 些 变 量 的 含义 完 
全 不 清楚 。 


代码 清单 2-1 语 境 不 明确 的 变量 


private void printGuessStatistics(char candidate, int count) { 
String number; 
String verb; 
String pluralModifier; 
if (count -- 0) ( 
number - "no"; 
verb = "are"; 
pluralModifier = "s"; 
} else if (count == 1) { 
number = "1"; 
verb = "is"; 
pluralModifier = ""; 
) else ( 


number - Integer.toString(count); 
verb - "are"; 
pluralModifier - "s"; 
} 
String guessMessage = String.format( 
"There 96s 96s %S%S", verb, number, candidate, pluralModifie 


: 
); 


print(guessMessage); 





上 列 函 数 有 点 儿 过 长 ， 变 量 的 使 FUR 
要 分 解 这 个 函数 ， 需 要 创建 一 个 名 为 
GuessStatisticsMessage 的 类 ， 把 三 个 变量 做 成 该 类 
的 成 员 字 上段。 这 样 它们 就 在 定义 上 变 作 了 
GuessStatisticsMessage 的 一 部 分 。 语 境 的 增强 也 让 
算法 能 够 通过 分 解 为 更 小 的 图 数 而 变 得 更 为 干 准 利 














o 【如 代码 清单 2-2 所 示 。 ) 
代码 清单 2-2 ”有 语 境 的 变量 








public class GuessStatisticsMessage { 
private String number; 
private String verb; 
private String pluralModifier; 


public String make(char candidate, int count) ( 
createPluralDependentMessageParts(count); 
return String.format( 
"There 96s 96s %S%S", 
verb, number, candidate, pluralModifier ); 


j 


private void createPluralDependentMessageParts(int count) { 
if (count == 0) { 
thereAreNoLetters(); 
) else if (count == 1) { 
therelIsOneLetter(); 
) else ( 
thereAreManyLetters(count); 
} 
} 


private void thereAreManyLetters(int count) ( 
number - Integer.toString(count); 
verb - "are"; 
pluralModifier - "s"; 


j 


private void thereIsOneLetter() { 
number = "1"; 
verb = "is"; 
pluralModifier = ""; 


j 


private void thereAreNoLetters() ( 
number = "no"; 
verb = "are"; 
pluralModifier = "s"; 


j 


2.17 ^4 XS ATE HERI V HR 


KEA TAZSmupxste" (Gas Station 
Deluxe) WMH, ZEEE PS ZSUSIIGSDRI A 
不 是 什么 好 点 子 。 说 白 了 ， 你 是 在 和 目 己 在 用 的 工 
具 过 不 去 。 输 入 G， 按 下 目 动 完成 键 ， 结 果 会 得 到 
系统 中 全 部 类 的 列表 ， 列 表 恨 不 得 有 一 英里 那么 
ie 这 样 做 聪明 吗 ? 为 什么 要 摘 得 IDE 没 法 帮助 
AS 

















再 比如 ， 你 在 GSD 应 用 程序 中 的 记 账 模块 创建 
了 一 个 表示 邮件 地 址 的 类 ， 然 后 给 该 类 命名 为 
GSDAccountAddress。 稍 后 ， 你 的 客户 联络 应 用 中 
需要 用 到 邮件 地 址 ， 你 会 用 GSDAccountAddress 
吗 ? 这 名 字 听 起 来 没 问 题 吗 ? 在 这 17 个 字母 里 面 ， 
有 10 个 字母 纯 必 多余 和 与 当前 语 境 坚 无 天 联 。 


只 要 短 名 称 足 够 清楚 ， 束 要 比 长 名 称 好 。 别 给 
名 称 添 加 不 必要 的 语 境 。 


对 于 Address 类 的 实体 来 说 ，accountAddress 和 
customerAddress 都 是 不 错 的 名 称 ， 不 过 用 在 类 名 上 
MLA AG Sf. Addressee SHAY. WR RBS 
MAC 地 址 、 端 口 地 址 和 Web 地 址 相 区 别 ， 我 会 考虑 
使 用 PostalAddress、MAC 和 URI。 这 样 的 名 称 更 为 











FE. TUS IE dm ts HI A o 


2.18 ”最 后 的 话 


取 好 名 字 最 难 的 地 方 在 于 需要 民 好 的 描述 技巧 
和 共有 文化 背景 。 与 其 说 这 是 一 种 扩 术 、 丙 业 或 管 
理 问题 ， 还 不 如 说 是 一 种 教学 问题 。 其 绩 朱 是 ， 这 
个 领域 内 的 许多 人 都 没 能 学 会 做 得 很 好 。 


我 们 有 时 会 介 其 他 开 肥 者 反对 重 命名 。 如 朱 讨 
论 一 下 就 知道 ， 如 果 名 称 改 得 更 好 ， 那 大 家 真 的 会 
感 油 你 。 多 数 时 候 我 们 并 不 记忆 关 名 和 方法 和 名。 我 
们 使 用 现代 工具 对 付 这 些 细 市 ， 好 让 自己 集中 精力 
于 把 代码 写 得 残 像 词句 篇 革 、 全 少 像 是 表 和 数据 结 
构 〈 词 名 并 非 总 是 呈现 数据 的 最 佳 手段 ) 。 改 名 可 
能 会 让 东 人 吃惊 ， 惑 像 你 做 到 其 他 代码 改善 工作 一 
样 。 别 让 这 种 事 阻碍 你 的 前 进步 代 é。 


不 妨 试 试 上 面 这 些 规 则 ， 看 你 的 代码 可 读 性 是 
否 有 所 提升 。 如 果 你 是 在 维护 别人 写 的 代码 ， 使 用 
重 构 工具 来 解决 问题 。 效 果 立 笔 见 影 ， 而 且 会 持续 


























[2] EYE: 即 hypotenuse 的 缩写 。 





[3] JRE: 如 后 文 提 到 的 ， 即 便 容 器 束 是 个 List， 
最 好 也 别 在 名 称 中 写 出 容器 类 型 名 。 


[4] JRE: 例如 ， 束 因为 class 已 有 他 用 ， 束 给 一 
个 变量 命名 为 klass， 这 真是 可 怕 的 做 法 。 


[5] JRE: 鲍 动 大 频 惯 于 在 C++ 中 这 样 做 ， 但 后 来 
放弃 了 ， 因 为 现代 IDE 使 这 种 做 法 变 得 没 必 要 了 。 


[6] YE: BCR3CNT 的 读音 。 





[7] AYE: PSZQ 的 读音 。 
[8] PAE: YMDHMS 的 读音 。 


[9] HE: £2llgeneration timestamp 时 ， 立 刻 就 能 
与 代码 中 的 generationTimestamp 变 量 对 应 上 。 


[10] Jk 


yÈ: http://java.sun.com/products/javabeans/docs/spec.t 





[1] FE: 塌 为 "圣手 手雷 "。 
12) 译注 ， 意 为 "删除 条 目 ”。 


[13] KE, B5. 


[14] Ef, Xm. 
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在 编程 的 早年 风月， 系统 由 程序 和 子 程序 组 
成 。 后 来 ， 在 Fortran 和 PL/1 的 年 代 ， 系 统 由 程序 、 
子 程序 和 函数 组 成 。 如 今 ， 只 有 函数 存活 下 来 。 函 





数 是 所 有 程序 中 的 第 一 组 代码 。 本 章 将 讨论 如 何 写 
好 函数 。 


请 看 代码 清单 3-1。 在 FitNesse lH 中 ， 很 难 找 
到 长 函数 ， 不 过 我 还 是 搜寻 到 一 个 。 它 不 光 长 ， 而 
且 代 码 也 很 复杂 ， 有 大 量 字 人 符 串 、 怪 异 而 不 显 见 的 
数据 类 型 和 API。 人 论 3 分 钟 时 间 ， 看 能 读 懂 多少? 


代码 清单 3-1 HtmlUtil.java (FitNesse 20070619) 














public static String testableHtml( 
PageData pageData, 
boolean includeSuiteSetup 
) throws Exception { 
WikiPage wikiPage - pageData.getWikiPage(); 
StringBuffer buffer - new StringBuffer(); 
if (pageData.hasAttribute("Test")) { 
if (includeSuiteSetup) { 
WikiPage suiteSetup - 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUITE SETUP NAME, wikiPage 
) 1 


if (suiteSetup !- null) { 
WikiPagePath pagePath - 
suiteSetup.getPageCrawler().getFullPath(suiteSetup); 
String pagePathName - PathParser.render(pagePath); 
buffer.append("!include -setup .") 
.append(pagePathName ) 
.append(" Nn"); 
} 
} 
WikiPage setup = 
PageCrawlerlImpl.getInheritedPage("SetUp", wikiPage); 
if (setup != null) ( 
WikiPagePath setupPath - 
wikiPage.getPageCrawler().getFullPath(setup); 
String setupPathName - PathParser.render(setupPath); 
buffer.append("!include -setup .") 


.append(setupPathName) 
.append(" n"); 
} 


} 
buffer.append(pageData.getContent()); 


if (pageData.hasAttribute("Test")) { 
WikiPage teardown - 
PageCrawlerlImpl.getInheritedPage("TearDown", wikiPage); 
if (teardown !- null) ( 
WikiPagePath tearDownPath - 
wikiPage.getPageCrawler().getFullPath(teardown); 
String tearDownPathName - PathParser.render(tearDownPath); 
buffer.append("\n") 
.append("!include -teardown .") 
.append(tearDownPathName ) 
.append(" An"); 


if (includeSuiteSetup) { 
WikiPage suiteTeardown - 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUITE TEARDOWN NAME, 
wikiPage 
); 
if (suiteTeardown !- null) ( 
WikiPagePath pagePath - 
suiteTeardown.getPageCrawler().getFullPath (suiteTeardo 


wn); 
String pagePathName - PathParser.render(pagePath); 
buffer.append("!include -teardown .") 
.append(pagePathName ) 
.append(" An"); 
} 
} 
} 


pageData.setContent(buffer.toString()); 
return pageData.getHtml(); 


j 





rE SPA 032 大 概 疫 有 。 有 太 多 事 发 





生 ， 有 太 多 不 同 层 级 的 抽象 。 奇 怪 的 字符 串 和 函数 


调用 ， 混 以 双重 舱 套 、 用 标识 来 控制 的 计 语 句 等 ， 
不 一 而 足 。 


不 过 ， 只 要 做 几 个 简单 的 方法 抽 离 和 重 命 名 操 
ies ie 点 点 重 构 ， 就 能 EITRI VS dis d 
(如 代码 清单 3-2 所 示 ) 。 用 3 分 钟 阅读 以 下 代码 ， 
看 你 能 理解 吗 ? 








代码 清单 3-2” HtmlUtiljava ( 重 构 之 后 ) 


public static String renderPageWithSetupsAndTeardowns( 
PageData pageData, boolean isSuite 
) throws Exception { 
boolean isTestPage - pageData.hasAttribute("Test"); 
if (isTestPage) { 
WikiPage testPage - pageData.getWikiPage(); 
StringBuffer newPageContent - new StringBuffer(); 
includeSetupPages(testPage, newPageContent, isSuite); 
newPageContent.append(pageData.getContent()); 
includeTeardownPages(testPage, newPageContent, isSuite); 
pageData.setContent(newPageContent.toString()); 


return pageData.getHtml(); 
j 








除非 你 正在 研究 FitrNesse， 奋 则 就 理解 不 了 所 
有 细 市 。 不 过 ， 你 大 概 能 明日 ， 该 函数 包含 把 一 些 
设置 和 拆 解 页 放 入 一 个 测试 页 面 ， 册 泻 染 为 HTML 
的 操作 。 如 果 你 熟悉 JUnit P! , IZ PKI 
数 归属 于 某 个 基于 Web 的 测试 框架 这 当然 
没 钳 。 从 代码 清单 3-2 中 获得 信息 4 TUR 而 代码 
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征 什么 让 代码 清单 3-2 易 于 阅读 和 理解 ?怎么 
才能 让 函数 表达 其 意图 ? 该 给 函数 赋予 哪些 属性 ， 
好 让 读者 一 看 束 明 白 函 数 是 属于 怎样 的 程序 ? 








3.1 短小 


水 数 的 第 一 规则 是 要 短小 。 第 二 条 规则 是 还 要 
更 短小 。 我 无 法 证 明 这 个 断言 。 我 给 不 出 任何 证 
实 了 小 函数 更 好 的 研究 结果 。 我 能 说 的 是 ， 近 40 年 
来 ， 我 写 过 各 种 不 同 大 小 的 函数 。 我 写 过 令 人 民 恶 
的 长 达 3000 行 的 厌 物 ， 也 与 过 许多 100 行 到 300 行 的 
函数 ， 我 还 写 过 20 行 到 30 行 的 。 经 过 漫长 的 试 错 ， 
ARTUR., KAIZ o 


E2080 FR, RITE WRAAK T — 
Fo MAPA, WAXER, VT100B5f H241T. 
80 列 ， 而 编辑 如 束 得 先 占 去 4 行 空间 放 末 日 。 如 
今 ， 用 上 了 精致 的 字体 和 宽大 的 显示 器 ， 一 屏 里 面 
可 以 显示 100 行 ， 每 行 能 容纳 150 个 字符 。 每 行 都 不 
应 该 有 150 个 字符 那么 长 。 函 数 也 不 该 有 100 行 那么 
长 ，20 行 封顶 最 佳 。 


函数 到 底 该 有 多 长 ? 1991 年， 我 去 Kent Beck 位 
于 奥 勒 交州 (Oregon) 的 家 中 拜访 。 我 们 坐 到 一 起 
写 了 些 代 人 码 。 他 给 我 看 一 个 叫做 Sparkle KEN 
We) 的 有 趣 的 Java/Swing 小 程序 。 程 序 在 屏幕 上 描 
画 电 影 Cinderella 〈《《 灰 姑娘 》) 中 仙女 用 麻 棱 造 出 
的 那 种 视 帝 效果。 只 要 移动 鼠标 ， 光 标 所 在 处 束 会 
































娄 发 出 一 团 令 人 欣喜 的 火花 ， 沿 看 模拟 重力 场 划 沙 
到 窗口 底部 。 肯 特 给 我 看 代码 的 时 候 ， 我 惊讶 于 其 
中 那些 函数 尺寸 之 小 。 我 看 惯 了 Swing 程序 中 长 度 
数 以 里 计 的 函数 。 但 这 个 程序 中 每 个 函数 都 只 有 
两 行 、 三 行 或 四 行 长 。 每 个 函数 都 一 目 了 然 。 每 个 
函数 都 只 说 一 件 事 。 而 且 ， 每 个 函数 都 依 序 把 你 带 
到 下 一 个 函数 。 这 束 是 函数 应 该 达到 的 短小 程 
度 ! bB] 

国 数 应 该 有 多 短小 ? 通 弟 来 说 ， 应 该 短 于 代码 
清单 3-2 中 的 函数 ! 代码 清单 3-2 实 在 应 该 缩短 成 代 
码 清单 3-3 这 个 样子 。 


代码 清单 3-3 HtmlUtil.java (ARKH JE) 























public static String renderPageWithSetupsAndTeardowns( 
PageData pageData, boolean isSuite) throws Exception { 
if (isTestPage(pageData)) 
includeSetupAndTeardownPages(pageData, isSuite); 


return pageData.getHtml(); 


j 





代码 块 和 缩 进 


if 语 句 、else 语 句 、while 语 句 等 ， 其 中 的 代码 
块 应 该 只 有 一 行 。 该 行 大 抵 应 该 是 一 个 函数 调用 语 
句 。 这 样 不 但 能 保持 函数 短小 ， 而 且 ， 因 为 块 内 调 
用 的 函数 拥有 较 有 具 说 明 性 的 名 称 ， 从 而 增加 了 文档 





上 的 价值 。 


这 也 意味 痢 冰 数 不 应 该 大 到 足以 容纳 磐 套 结 
构 。 所 以 ， 函 数 的 缩 进 层 级 不 该 多 于 一 层 或 两 层 。 
当然 ， 这 样 的 函数 易于 阅读 和 理解 。 











3.2 ”只 做 一 件 事 


代码 清单 3-1 显 然 想 做 好 几 件 事 。 它 创建 缓冲 
区 、 获 取 页 面 、 搜 索 继 承 下 来 的 页 面 、 演 染 路 径 、 
添加 神秘 的 字符 串 、 生 成 HTML， 如 此 等 等 。 代 码 
清单 3-1 手 忙 脚 乱 。 而 代码 清单 3-3 则 只 做 一 件 简单 
的 事 。 它 将 设置 和 拆 解 包 纳 到 测试 页 面 中 。 








过 去 30 年 以 来 ， 以 下 建议 以 不 同形 式 一 再 出 


现 : 


— oe 做 好 这 件 事 。 只 做 这 一 


问题 在 于 很 难 知道 那 件 该 做 的 事 是 什么 。 代 码 
清单 3-3 只 做 了 一 件 事 ， 对 吧 ? 其 实 也 很 容易 看 作 





是 三 件 事 : 
(1) 判断 是 侣 为 测试 页 面 ; 
(2) 如 果 是 ， 则 容纳 进 设置 和 分 拆 步 又; 
(3) THZSEXHTML. 


那 件 事 是 什么 ? 函数 是 做 了 一 件 事 呢 ， 还 是 做 
了 三 件 事 ? 注意 ， 这 三 个 步骤 均 在 该 函数 名 下 的 同 
一 抽象 层 上 。 可 以 用 简洁 的 TO 引起 头 段落 来 描述 
这 个 函数 : 


TO RenderPageWithSetupsAndTeardowns, we 
check to see whether the page is a test page and if so, 
we include the setups and teardowns. In either case we 
render the page in HTML. 


C: RenderPageWithSetupsAndTeardowns , Ts 
frm e SAMA, Wien. UAE 
EMAAR. Tee SIA, AAA 
HTML) 


AA ER BUR ES ABA P le] HE 
ZU, MRR BR R e M SR. 编写 函 数 毕 苋 是 
为 了 把 大 一 些 的 概念 换言之， 函数 的 名 称 〉 拆 分 
为 妨 一 抽象 屋 上 的 一 系列 步 又 。 





代码 清单 3-1 明 显 包括 了 处 于 多 个 不 同 抽象 层 
级 的 步骤 。 显 然 ， 它 所 做 的 不 止 一 件 事 。 即 便 是 代 
但 清单 3-2 也 有 两 个 抽象 层 ， 这 已 被 我 们 将 其 缩短 
的 能 力 所 证 明 。 然 而 ， 很 难 再 将 代码 清单 3-3 做 有 
意义 的 缩短 。 可 以 将 证 语句 拆 出 来 做 一 个 名 为 
includeSetupAndTeardonws IfTestpage 的 函数 ， 但 那 
只 征 重 新 诠释 代码 ， 并 未 改变 抽象 层级 。 


所 以 ， 要 判断 函数 是 否 不 止 做 了 一 件 事 ， 还 有 
— Porn 就是 看 是 ER Ay He Fa EH — AR 数 ， ix PR 数 
MYR 是 单纯 地 重新 诠释 其 实现 [G34]。 


ER C p S X B 


请 看 代码 清单 47。 注 意 ，generatePrimes 函 数 
被 切 分 为 declarations、initializations 和 sieve 等 区 
段 。 这 束 是 函数 做 事 太 多 的 明显 征兆 。 只 做 一 件 事 
的 函数 无 法 被 合理 地 切 分 为 多 个 区 段 。 























3.3 每 个 函数 一 个 抽象 层级 


要 确保 函数 只 做 一 件 事 ， 函 数 中 的 语句 都 要 在 
同一 抽象 层级 上 。 一 眼 就 能 看 出 ， 代 人 码 清单 3-1 违 
反 了 这 条 规 容 。 那 里 面 有 getHtml( ) 等 位 于 较 高 抽象 
层 的 概念 ， 也 有 String pagePathName = 
PathParser.render(pagePath) <3: 7 F P |e) fh & JE KA 
仿 ， 还 有 .append("\n") 等 位 于 相当 低 的 抽象 层 的 概 


TA o 








& ¢ 


函数 中 混杂 不 同 抽象 层级 ， 往 往 让 人 迷惑 。 读 
者 可 能 无 法 判断 某 个 表达 式 是 基础 概念 还 是 细节 。 
就 像 破损 的 窗户 ， 一 旦 细节 与 基础 概 
念 混杂 ， 更 多 的 细节 就 会 在 函数 中 纠结 起 来 。 


EI PERRA: Hg PU 


我 们 想 要 让 代码 拥有 自 项 向 下 的 阅读 顺序 。 D 
我 们 想 要 让 每 个 函数 后 面 都 跟着 位 于 下 一 抽象 层级 
的 函数 ， 这 样 一 来 ， 在 查看 函数 列表 时 ， 束 能 颂 抽 
象 层 级 加 下 阅读 了 。 我 把 这 叫做 同 下 规则 。 


换 一 种 说 法 。 我 们 楚 — o 程序 就 像 
一 系列 TO 起 头 的 段落 ， 每 一 段 都 描述 当前 抽象 
M FALF es hum TO EK x 

















To include the setups and teardowns, we include 
setups, then we include the test page content, and then 
we include the teardowns. 〈 要 容纳 设置 和 分 拆 步 
又 ， 束 移 容 纳 设 置 步 又 ， 然 后 纳入 测试 页 面 内 容 ， 
再 纳入 分 拆 步骤 。 ) 





To include the setups, we include the suite setup if 
this is a suite, then we include the regular setup. (Œ 
BOKER, WREEF, MAAR REY 
又 ， 然 后 再 纳入 普通 设置 步 又。 ) 


To include the suite setup, we search the parent 
hierarchy for the “SuiteSetUp” page and add an 
include statement with the path of that page. (要 容纳 
套件 设置 步 又， 先 搜索 “SuiteSetUp” 页 面 的 上 级 继 
承 基 系 ， 再 添加 一 个 包括 该 页 面 路 径 的 语句 。 ) 


To search the parent... CHRR... ) 


程序 员 往 往 很 难 学 会 遵循 这 条 规则 ， 写 出 只 停 
留 于 一 个 抽象 层级 上 的 函数 。 尽 管 如 此 ， 学 习 这 个 
技巧 还 是 很 重要 。 这 是 你 持 函 数 短 小 、 确 你 只 做 一 
件 事 的 要 诀 。 让 代码 读 起 来 像 是 一 系列 目 顶 同 下 的 
TO 起 头 段落 是 保持 抽象 层级 协调 一 致 的 有 效 技 





Tj. 


看 看 本 草 末 尾 的 代码 清单 3-7。 它 展示 了 遵循 
这 条 原则 重 构 的 完整 testableHtml 函 数 。 留 意 每 个 函 
数 是 如 何 引 出 下 一 个 浮 数 ， 如 何 保持 在 同一 抽象 层 
上 的 。 











3.4 switch 语句 





写 出 短小 的 switch 语 句 很 难 16! 。 即 便 是 只 有 两 
种 条 件 的 switch 语 句 也 要 比 我 想 要 的 单个 代码 块 或 
函数 大 得 多 。 写 出 只 做 一 件 事 的 Switch 语句 也 很 
难 。Switch 天 生 要 做 N 件 事 。 不 竺 我 们 总 无 法 避 开 
switch 语 句 ， 不 过 还 是 能 够 确保 每 个 switch 都 埋藏 在 
较 低 的 抽象 层级 ， 而 且 永 远 不 重复 。 当 然 ， 我 们 利 
用 多 态 来 实现 这 一 点 。 








请 看 代码 清单 3-4。 它 呈现 了 可 能 依赖 于 雇员 
类 型 的 仅仅 一 种 操作 


代码 清单 3-4 Payroll.java 


public Money calculatePay(Employee e) 
throws InvalidEmployeeType { 
switch (e.type) { 
case COMMISSIONED: 
return calculateCommissionedPay(e); 
case HOURLY: 
return calculateHourlyPay(e); 
case SALARIED: 


return calculateSalariedPay(e); 
default: 
throw new InvalidEmployeeType(e.type); 
} 
} 





该 水 数 有 好 几 个 问题 。 首 先 ， 它 太 长 ， 当 出 现 
新 的 雇员 类 型 时 ， 还 会 变 得 更 长 。 其 次 ， 它 明显 做 
了 不 止 一 件 事 。 第 三 ， 它 违反 了 单一 权 员 原则 
(Single Responsibility Principle ! , SRP) ， 因 为 有 
好 几 个 修改 它 的 理由 。 第 四 ， 它 违反 了 开放 闭合 原 
则 (Open Closed Principle 8, OCP) ， 因 为 每 当 添 
加 新 类 型 时 ， 束 必须 修改 之 。 不 过 ， 该 函数 最 矿 烦 
ee 例如 ， 可 能 会 


isPayday(Employee e, Date date), 


at 


deliverPay(Employee e, Money pay), 


如 此 等 等 。 它 们 的 结构 都 有 同样 的 问题 。 


该 问题 的 解决 方 采 《如 代码 清单 3-5 所 示 ) 是 
将 switch 语 句 埋 到 抽象 工厂 91 底下 ， 不 让 任何 人 看 
到 。 该 工厂 使 用 switch 语 句 为 Employee 的 派生 物 创 
建 适 当 的 实体 ， 而 不 同 的 函数 ， 如 calculatePay、 
isPayday 和 deliverPay 等 ， 则 精 由 Employee 接 口 多 态 
PE SS YR IE . 








对 于 switch 语 句 ， 我 的 规 窍 是 如 果 只 出 现 一 
次 ， 用 于 创建 多 态 对 象 ， 而 且 隐 藏 在 某 个 继承 关系 
中 ， 在 系统 其 他 部 分 看 不 到 ， 束 还 能 容 礼 [G23]。 
当然 也 要 就 事 论 事 ， 有 时 我 也 会 部 分 或 全 部 违反 这 
A URB e 








代码 清单 3-5” Employee TJ - 


public abstract class Employee ( 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 


public interface EmployeeFactory ( 


public Employee makeEmployee(EmployeeRecord r) throws InvalidE 
mployeeType; 
} 


public class EmployeeFactoryImpl implements EmployeeFactory { 
public Employee makeEmployee(EmployeeRecord r) throws InvalidE 
mployeeType { 
switch (r.type) (1 
case COMMISSIONED: 
return new CommissionedEmployee(r) ; 
case HOURLY: 
return new HourlyEmployee(r); 
case SALARIED: 
return new SalariedEmploye(r); 
default: 
throw new InvalidEmployeeType(r.type); 





3.5 ”使 用 摘 述 性 的 名 称 
在 代码 清单 3-7 中 ， 我 把 示例 函数 的 名 称 从 


testableHtml 改 为 SetupTeardownIncluder.render。 这 
个 名 称 好 得 多 ， 因 为 它 较 好 地 描述 了 函数 做 的 事 。 
我 也 给 每 个 私有 方法 取 个 同样 具有 描述 性 的 名 称 ， 
如 isTestable 或 includeSetupAndTeardownPages。 好 
名 称 的 价值 怎么 好 评 都 不 为 过 。 记 住 沃 德 原 

则 ; “如 果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 
整洁 代码 。 ”要 巡 循 这 一 原则 ， 泰 半 工 作 都 在 于 为 
只 做 一 件 事 的 小 函数 取 个 好 名 字 。 子 数 越 短 小 、 功 
HERRERA, LEE TIN Sa A. 


AFAR AM IE BORTISTEBUAAPR, TREO 
A TU Ao A BRA AA RAE S TR TT RUE HRE, 
BELG THIA TER TERE. HEAR Mas BADE, WM 
数 名 称 中 的 多 个 单词 容易 阅读 ， 然 后 使 用 这 些 单词 
给 函数 取 个 能 说 清 其 功用 的 名 称 。 


别 害怕 花 时 间 取 名 字 。 你 当 尝 试 不 同 的 名 称 ， 
实测 其 阅读 效果 。 在 Eclipse 或 IntelliJ 等 现代 IDE 中 
改名 称 易 如 反 和 擎 。 使 用 这 些 IDE 测 斌 不同 名称， 下 
至 找到 最 具有 描述 性 的 那 一 个 为 止 。 


选择 描述 性 的 名 称 能 理 清 你 关于 模块 的 设计 思 




















路 ， 并 帮 你 改进 之 。 追 索 好 名 称 ， 往 往 寻 致 对 代码 
的 改善 重 构 。 


命名 方式 要 保持 一 致 。 使 用 与 模块 名 一 脉 相 承 
的 短语 、 名 词 和 动词 给 函数 命名 。 例 如 ， 
includeSetupAndTeardownPages、 
includeSetupPages、includeSuiteSetupPage 和 
includeSetupPage 等 。 这 些 名 称 使 用 了 类 似 的 措 群 ， 
依 序 讲 出 一 个 故事 。 实 际 上 ， 假 使 我 只 给 你 看 上 述 
KAUTA, PRZ H I: *"incuudeTeardownPages. 
includeSuiteTeardownPages 和 includeTeardownPage 
又 会 如 何 ? ”这 了 就 是 所 谓 “ 深 合 己 意 ”了 。 





3.6 (KL 2 


REM NS Bes (SBMA . XX 
是 一 《〈 单 参数 函数 ) ， 再 次 是 二 〈 双 参数 函数 ) , 
应 义 量 避免 三 《三 参数 函数 ) 。 有 足够 特殊 的 理由 
才能 用 三 个 以 上 参数 〈 多 参数 函数 ) 一 一 所 以 无 论 
如 何 也 不 要 这 么 做 。 














参数 不 易 对 付 。 它 们 带 有 太 多 概念 性 。 所 以 我 


在 代码 范例 中 几乎 不 加 参数 。 比 如 ， 以 StringBuffer 
为 例 ， 我 们 可 能 不 把 它 作 为 实体 变量 ， 而 是 当 作 参 
数 来 传递 ， 那 样 的 话 ， 读 者 每 次 看 到 和 它 都 得 要 翻译 
一 表 。 阅 读 模 块 所 讲述 的 故事 时 ， 
includeSetupPage( ) 要 比 

includeSetupPageInto (newPage-Content) 4j T 8 
解 。 参 数 与 函数 名 处 在 不 同 的 抽象 层级 ， 它 要 求 你 
了 解 目 前 并 不 特别 重要 的 细 和 《 即 那个 
StringBuffer) 。 


从 测试 的 角度 看 ， 参 数 甚 至 更 叫 人 为 难 。 想 想 
看 ， 要 编写 能 确 你 参数 的 各 种 组 合 运 行 正 第 的 测试 
用 例 ， 是 多 么 困难 的 事 。 如 条 没 有 参数 ， 藉 是 小 这 
一 代 。 如 条 只 有 一 个 参数 ， 也 不 太 困 难 。 有 两 个 参 
7h, HARMS Y. WDRASUCETPT. JE 
ii PE A Re ZAG fe Bit AERE. 


输出 参数 比 输 入 参数 还 要 难以 理解 。 读 函数 
时 ， 我 们 惯 于 认为 信息 通过 参数 输入 函数 ， 通 过 返 
回 值 从 函数 中 输出 。 我 们 不 太 期 望 信息 通过 参数 
输出 。 所 以 ， 输 出 参数 往往 让 人 吾 思 之 后 才 悦 然 大 
小 五 


Fo 





























相 较 于 没有 参数 ， 只 有 一 个 输入 参数 算是 第 二 
好 的 做 法 。 
SetupTeardownInclude.render (pageData) 也 相当 吻 


于 理解 。 很 明显 ， 我 们 将 演 染 pageData 对 象 中 的 数 
HE o 


3.6.1 — JE PER E JE A 


问 图 数 传 入 单个 参数 有 两 种 极 普 壳 的 理由 。 你 
也 许 会 问 关 于 那个 参数 的 问题 ， 吏 像 在 boolean 
fileExists("MyFile") 中 那样 。 也 可 能 是 操作 该 参数 ， 
将 其 转换 为 其 他 什么 东西 ， 再 输出 之 。 例 如 ， 
InputStream fileOpen("MyFile") 把 String 类 型 的 文件 
名 转换 为 InputStream 类 型 的 返回 值 。 这 就 是 读者 看 
到 函数 时 所 期 竺 的 东西 。 你 应 当选 用 较 能 区 别 这 两 
eom 而 且 总 在 一 致 的 上 下 文中 使 用 这 两 
种 形式 。 


还 有 一 种 虽 不 那么 普 衣 但 仍 极 有 用 的 单 参数 函 
输入 参数 而 无 输出 参数 。 程 序 将 函数 看 作 是 一 个 事 
件 ， 使 用 该 参数 修改 系统 状态 ， 例 如 void 
passwordAttemptFailedNtimes(int attempts)。 小 心 使 
用 这 种 形式 。 应 该 让 读者 很 清楚 地 了 解 它 是 个 事 
件 。 谨 慎 地 选用 名 称 和 上 下 文 语 卉 。 


尽量 避免 编写 不 如 循 这 些 形式 的 一 元 函数 ， 例 
如 ，void includeSetupPagelnto(StringBuffer 
pageText)。 对 于 转换 ， 使 用 输出 参数 而 非 返 回 值 令 

















人 迷惑 。 如 条 图 数 要 对 输入 参数 进行 转换 操作 ， 转 
换 结 果 就 该 体现 为 返回 值 。 实 际 上 ，StringBuffer 
transform(StringBuffer in) 要 比 void 
transform(StringBuffer oub 强 ， 即 便 第 一 种 形式 只 人 简 
单 地 返回 得 参数 也 是 这 样 。 至 少 ， 写 遵循 了 转换 的 
JEXX. 


3.6(.0 ”标识 参数 


标识 参数 丑陋 不 堪 。 同 函数 传 入 布尔 值 简直 了 吏 
是 骇 人 上 听 国 的 做 法 。 这 样 做 ， 方 法 签名 立刻 变 得 复 
林 起 来 ， 大 声 宣布 本 函数 不 止 做 一 件 事 。 如 果 标 识 
为 true 将 会 这 样 做 ， 标 识 为 false 则 会 那样 做 ! 


在 代码 清单 3-7 中 ， 我 们 列 无 选择 ， 因 为 调用 
者 已 经 传 入 了 那个 标识 ， 而 我 想 把 重 构 范围 限制 在 
该 函数 及 该 函数 以 下 范围 之 内 。 方 法 调用 
render(true) 对 于 可 怜 的 读者 来 说 仍然 摸 不 着 头脑 。 
z) BR, A #llrender(Boolean isSuite]， 稍 许 有 点 
帮助 ， 不 过 仍然 不 够 。 应 该 把 该 函数 一 分 为 二 : 
reanderForSuite( ) 和 renderForSingleTest( )。 

















3.6.3 ”二 元 函数 
有 了 两 个 参数 的 函数 要 比 一 元 函数 难 懂 。 例 如 ， 


writeField(name) LU writeField(outputStream, name) 


[10] 好 懂 。 


尽管 两 种 情况 下 意义 部 很 清楚 ， 但 第 一 个 只 要 
扫 一 眼 就 明日 ， 更 好 地 表达 了 其 音义。 第 二 个 厌 得 
暂 俘 一 下 才能 明日 ， 除 非 我 们 学 会 忽略 第 一 个 参 
数 。 而 且 最 终 那 也 会 叶 致 问题 ， 因 为 我 们 根本 就 不 
该 忽略 任何 代码 。 和 忽略 挥 的 部 分 束 古 缺陷 藏 喘 之 
地 。 


当然 ， 有 些 时 候 两 个 参数 正好 。 例 如 ，Point p 
= new Point(0,0); 就 相当 合理 。 笛 卡 儿 点 天 生 拥 有 两 
个 参数 。 如 果 看 到 new Point(0)， 我 们 会 倍 感 惊讶 。 
然而 ， 本 例 中 的 两 个 参数 却 只 是 单个 值 的 有 序 组 成 
部 分 ! 而 output-Stream 和 name 则 既 非 自然 的 组 合 ， 
也 不 是 目 然 的 排序 。 


即便 是 如 assertEquals(expected, actual) 这 样 的 二 
元 函数 也 有 其 问题 。 你 有 多 少 次 会 摘 错 actual 和 
expected 的 位 置 呢 ?这 两 个 参数 没有 目 然 的 顺序 。 
expected 在 前 ，actual 在 后 ， 只 十 一 种 需要 学 习 的 约 
ES So 


二 元 函数 不 算 恶 劣 ， 而 且 你 当然 也 会 编写 二 元 
了 为数。 不过， 你 得 小 心 ， 使 用 二 元 函数 要 付出 代 
价 。 你 应 该 尽量 利用 一 些 机 制 将 其 转换 成 一 元 函 
数 。 例 如 ， 可 以 把 writeField 方 法 写成 outputStream 

















的 成 员 之 一 ， 从 而 能 这 样 用 : 
outputStream.writeField(name). skr, thay WE 
outputStream 写成 当前 类 的 成 员 变 量 ， 从 而 无 需 再 
传递 它 。 还 可 以 分 离 出 类 似 FieldWriter 的 新 类 ， 在 
其 构造 器 中 采用 outputStream， 并 且 包 含 一 个 write 
ds 








3.6.4 三 元 函数 


有 三 个 参数 的 函数 要 比 二 元 函数 难 懂得 多 。 排 
序 、 琢 磨 、 忽 略 的 问题 都 会 加 倍 体 现 。 建 议 你 在 写 
三 元 函数 前 一 定 要 想 清 楚 。 


例如 ， 设 想 assertEquals 有 三 个 参数 : 
assertEquals(message, expected, actual), A#> ix, 
你 读 到 message， 错 以 为 它 是 expected 呢 ? 我 就 常 栽 
在 这 个 三 元 函数 上 。 实 际 上 ， 每 次 我 看 到 这 里 ， 
忆 会 绕 半 天 疾 子 ， 最 后 学 会 了 怨 略 message 参 数 。 


男 一 方面 ， 这 里 有 个 并 不 那么 险恶 的 三 元 也 
数 : assertEquals(1.0, amount, .001)。 虽 然 也 要 费 点 
神 ， 还 是 值得 的 。 得 到 “ 浮 点 值 的 等 值 是 相对 而 
言 ?的 提示 总 是 好 的 。 


3.6.5 ”参数 对 象 














如 果 图 数 看 来 需要 两 个 、 三 个 或 三 个 以 上 参 
数 ， 惑 说明 其 中 一 些 参 数 应 该 封 痛 为 关 了 。 例 如 ， 





FB pA HB ERI ZI: 


Circle makeCircle(double x, double y, double radius); 
Circle makeCircle(Point center, double radius); 








从 参数 创建 对 象 ， 从 而 减少 参数 数量 ， 看 起 来 
像 是 在 作 几 ,但 实则 并 非 如 此 。 妆 一 组 参数 被 共同 
传递 ， 就 像 上 例 中 的 x 和 y 那 样 ， 往 往 就 是 该 有 自己 
名 称 的 荣 个 概念 的 一 部 分 。 


3.6.6 ”参数 列表 


有 时 ， 我 们 想 要 回 函 数 传 入 数量 可 变 的 参数 。 
例如 ，String.format 方 法 : 








String.format("%s worked %.2f hours.", name, hours); 





如 果 可 变 参 数 像 上 例 中 那样 被 同等 对 符 ， 了 驶 和 
类 型 为 List 的 单个 参数 没什么 两 样 。 这 样 一 来 ， 
String.formate 实 则 是 二 元 函数 。 下 列 String.format 的 
声明 也 很 明显 是 二 元 的 : 


public String format(String format, Object... args) 








同 理 ， 有 可 变 参 数 的 函数 可 能 是 一 元 、 二 元 其 
至 三 元 。 超 过 这 个 数量 丈 可 能 要 犯错 了 。 


void monad(Integer... args); 
void dyad(String name, Integer... args); 
void triad(String name, int count, Integer... args); 





3.6.7 动词 与 关键 字 


给 函数 取 个 好 名 字 ， 能 较 好 地 解释 函数 的 意 
图 ， 以 及 参数 的 顺序 和 意 网 。 对 于 一 元 函数 ， 函 数 
和 参数 应 当 形 成 一 种 非常 民 好 的 动词 /名 词 对 形式 。 
例如 ，write(name) 残 相当 令 人 认同 。 不 管 这 
个 “name” 是 什么 ， 都 要 被 “write”。 更 好 的 名 称 大 概 
是 writeField(name)， 它 告诉 我 们 ，“name” 古 一 
个 “field”。 


最 后 那个 例子 展示 了 函数 名 称 的 关键 字 
(keyword) 形式 。 使 用 这 种 形式 ， 我 们 把 参数 的 
名 称 编 码 成 了 图 数 名 。 例 如，assertEqual 改 成 
assertExpectedEqualsActual(expected, actual) 可 能 会 


好 些 。 这 大 大 减轻 了 记忆 参数 顺序 的 负担 。 





3.7 ”无 副作用 


副作用 是 一 种 度 言 。 函 数 承 访 只 做 一 件 事 ， 但 
还 是 会 做 其 他 被 藏 起 来 的 事 。 有 时 ， 它 会 对 目 己 类 
中 的 变量 做 出 未 能 预期 的 改动 。 有 时 ， 它 会 把 变量 
摘 成 回 函 数 传 递 的 参数 或 是 系统 全 局 变量 。 无 论 哪 
种 情况 ， 都 是 具有 破坏 性 的 ， 会 导致 古怪 的 时 序 性 
y tr I ILE ACR o 


以 代码 清单 3-6 中 看 似 无 伤 大 雅 的 图 数 为 例 。 
TZ PRI BE H ton HE AK VL Ac userName fll password. 
如 果 [ 罗 配 成 功 ， 返 回 true， 如 果 失 败 则 返回 false。 
但 它 会 有 副作用 。 你 知道 问题 所 在 吗 ? 


代码 清单 3-6  UserValidator.java 























public class UserValidator { 
private Cryptographer cryptographer; 


public boolean checkPassword(String userName, String password) 


User user - UserGateway.findByName(userName); 
if (user != User.NULL) { 
String codedPhrase = user.getPhraseEncodedByPassword( ); 
String phrase - cryptographer.decrypt(codedPhrase, passwor 
d); 
if ("Valid Password".equals(phrase)) { 
Session.initialize(); 
return true; 


return false; 


) 
BEEN 
“PRS. RIVE WE T Session.initialize( ) 的 
调用 。checkPassword 函 数 ， 顾 名 思 义 ， 就 是 用 来 检 
查 密码 的 。 该 名 称 并 末了 上 暗示 它 会 初始 化 该 次 会 话 。 
所 以 ， 当 某 个 误 信 了 函数 名 的 调用 者 想 要 检查 用 户 
有 效 性 时 ， 束 得 冒 抹 除 现 有 会 话 数 据 的 风险 。 


这 一 副作用 造 出 了 一 次 时 序 性 看 合 。 也 就 是 
说 ，checkPassword 只 能 在 特定 时 刻 调用 (换言之 ， 
在 初始 化 会 话 是 安全 的 时 候 调 用 ) 。 如 果 在 不 合适 
的 时 候 调 用 ， 会 话 数 据 就 有 可 能 沉默 地 丢失 。 时 序 
性 契合 令 人 迷惑 ， 特 别 是 当 它 跨 在 副作用 后 面 时 。 
如 果 一 定 要 时 序 性 耘 合 ， 惑 应 该 在 函数 名 称 中 说 
明 。 在 本 例 中 ， 可 以 重 命 名 函数 为 
checkPasswordAndlnitializeSession, 虽然 那 还 是 违 


有 反 了 “只 做 一 件 事 ” 的 规则 。 
输出 参数 
参数 多 数 会 被 目 然而 然 地 看 作 是 函数 的 输入 


。 如 果 你 编 过 好 些 年 程序 ， 我 担 你 你 一 定 被 用 作 输 
出 而 非 输 入 的 参数 迷惑 过 。 例 如 : 


appendFooter(s); 


























| 


这 个 函数 是 把 s 添 加 到 什么 东西 后 面 吗 ? 或 者 
它 把 什么 东西 洪 加 a 到 了 s 后 面 ? s 是 输入 参数 还 是 输 
出 参数 ? 各 许 论点 时 间 看 看 函数 签名 : 


public void appendFooter(StringBuffer report) 


事情 清楚 了 ， 但 付出 了 检查 函数 声明 的 代价 。 
你 被 迫 检 查 函 数 签 名 ， 残 得 伦 上 一 点 时 间 。 应 该 避 
免 这 种 中 断 思 路 的 事 。 

在 面 问 对 象 编 程 之 前 的 岁月 里 ， 有 时 的 确 需要 
输出 参数 。 然 而 ， 面 同 对 象 语言 中 对 输出 参数 的 大 
部 分 需求 已 经 消失 了 ， 因 为 this 也 有 输出 函数 的 意 
味 在 内 。 换 言 之 ， 最 好 是 这 样 调用 appendFooter: 


report.appendFooter(); 


普 届 而 言 ， 应 避免 使 用 输出 参数 。 如 末 函 数 必 
须要 修改 东 种 状态 ， 葡 修改 所 属 对 象 的 状态 吧 。 





























3.8 分隔 指 令 与 询问 


图 数 要 么 做 什么 事 ， 要 么 回答 什么 事 ， 但 二 者 
不 可 得 兼 。 函 数 应 该 修改 菏 对 象 的 状态 ， 或 是 返回 
该 对 象 的 有 关 人 信息。 两 样 都 干 第 会 叶 臻 混乱 。 看 看 
下 面 的 例子 : 


public boolean set(String attribute, String value); 


该 函数 设置 某 个 指定 属性 ， 如 果 成 功 束 返回 
true, 如果 不 存在 那个 属性 则 返回 false。 这 样 束 导 
致 了 以 下 语句 : 




















if (set("username", "unclebob"))... 





从 读者 的 角度 考虑 一 下 吧 。 这 是 什么 意思 呢 ? 
它 是 在 问 username 属 性 值 是 否 之 前 已 设置 为 
unclebob 吗 ?或 者 它 是 在 问 username 属 性 值 是 否 成 
功 设置 为 unclebob 呢 ? 从 这 行 调用 很 难 判 断 其 含 
义 ， 因 为 set 是 动词 还 是 形容 词 并 不 清楚 。 


作者 本 意 ，set 是 个 动词 ， 但 在 让 语句 的 上 下 文 
H, RE 它 像 是 个 形容 词 。 该 语句 读 起 来 像 是 














说 “如 果 username 属 性 值 之 前 已 被 设置 为 uncleob?”， 

而 不 是 “设置 username 属 性 值 为 nclebob， 看 看 是 合 
可 行 ， 然 后 ...... ”。 要 解决 这 个 问题 ， 可 以 将 set 函 

数 重 命名 为 setAndCheckIfExists， 但 这 对 提高 ff 语句 
的 可 读 性 帮助 不 大 。 真 正 的 解决 方案 是 把 指令 与 询 
问 分 隔 开 来 ， 防 止 混 请 的 发 生 : 





if (attributeExists("username")) { 
setAttribute("username", "unclebob"); 


j 





3.9 MEH F E BR El E RA 


MdB S ARBOR HENRI ES e Y T8 8] 
问 分 隅 的 规则 。 它 或 励 了 在 让 语 色 判 断 中 把 指令 当 
作 表 达 式 使 用 。 


if (deletePage(page) == E OK) 


这 不 会 引起 动词 /形容 词 混 淆 ， 但 却 导 致 更 深 
层次 的 仍 套 结构 。 当 返回 错误 码 时 ， 就 是 在 要 求 调 
用 者 立刻 处 理 错误 。 








if (deletePage(page) == E OK) { 
if (registry.deleteReference(page.name) == E OK) { 
if (configKeys.deleteKey(page.name.makeKey()) -- E OK)( 
logger.log("page deleted"); 
) else ( 
logger.log("configKey not deleted"); 


) else ( 


logger.log("deleteReference from registry failed"); 


) else { 
logger.log("delete failed"); 
return E ERROR; 

} 





一 方 和 面 ， 如 下 使 用 异 津 蔡 代 返回 错误 码 ， 错 


误 处 理 代 码 就 能 从 主 路 径 代 码 中 分 离 出 来 ， 得 到 简 
化 : 


try { 
deletePage(page); 
registry.deleteReference(page.name); 
configKeys.deleteKey(page.name.makeKey()); 


catch (Exception e) ( 
logger.log(e.getMessage()); 
j 





3.9.1 ji Try/CatchfAC hgk 


Try/catch 代 码 块 丑陋 不 堪 。 它 们 摘 乱 AREA 
构 ， 把 错误 处 理 与 正 营 流程 混为一谈 。 最 好 把 try 和 
catch 代 人 码 块 的 主体 部 分 抽 离 出 来 ， 男 外 形成 函数 。 








public void delete(Page page) { 


try { 
deletePageAndAllReferences(page); 


catch (Exception e) { 
logError(e); 
} 
} 


private void deletePageAndAllReferences(Page page) throws Excep 
tion ( 
deletePage(page); 
registry.deleteReference(page.name); 
configKeys.deleteKey(page.name.makeKey()); 
j 


private void logError(Exception e) ( 


logger.log(e.getMessage()); 
} 


在 上 例 中 ，delete 函 数 只 与 错误 处 理 有 天。 很 
容易 理解 然后 束 忽 略 挥 。 
deletePageAndAllReference 函 数 只 与 完全 删除 一 个 
page 有 关 。 错 误 处 理 可 以 忽略 挥 。 有 了 这 样 美妙 的 
区 隅 ， 代 码 束 更 易于 理解 和 修改 了 了。 


3.9.2 ”错误 处 理 驶 是 一 件 事 


函数 应 该 只 做 一 件 事 。 错 误 处 理 就 是 一 件 事 。 
因此 ， 处 理 错 误 的 函数 不 该 做 其 他 事 。 这 意味 着 
(如 上 例 所 示 ) 如果 关 键 字 try 在 某 个 函数 中 存在 ， 
它 束 该 是 这 个 函数 的 第 一 个 单词 ， 而 且 在 
catch/finally 代 码 块 后 面 也 不 该 有 其 他 内 容 。 














3.9.3 ”Error.java 依 赖 人 磁铁 


返回 错误 码 通 党 暗示 尔 处 有 个 类 或 是 枚 举 ， 定 
义 了 所 有 错误 人 码 。 





public enum Error { 
OK 


INVALID, 
NO_SUCH, 

LOCKED, 
OUT_OF_RESOURCES, 


WAITING FOR EVENT; 
Jj 


这 样 的 类 束 是 一 块 依赖 磁铁 (dependency 
magnet) ; 其 他 许多 类 都 得 导入 和 使 用 它 。 当 Error 
枚 举 修改 时 ， 所 有 这 些 其 他 的 类 都 需 要 重新 编译 和 
WEE. Ul 这 对 Error 类 造成 了 负面 压力 。 程 序 员 不 
愿 增加 新 的 错误 代码 ， 因 为 这 样 他 们 束 得 重新 构建 
AeA AARP. FERR IAA RAS, TT 
不 添加 新 的 。 


使 用 异常 替代 错误 码 ， 新 异常 就 可 以 从 异常 类 
派生 出 来 ， 无 需 重新 编译 或 重新 部 署 21 。 


3.10” 别 重复 自己 US 


回头 仔细 看 看 代码 清单 3-1， 你 会 注意 到 ， 有 
个 算法 在 SetUp、SuiteSetUp、TearDown 和 
SuiteTearDown 中 总 共 被 重复 了 4 次 。 识 别 重 复 不 大 
容易 ， 因 为 这 4 次 重复 与 其 他 代码 混在 一 起 ， 而 且 
也 不 完全 一 样 。 这 样 的 重复 还 是 会 导致 问题 ， 因 为 
代码 因此 而 用 和 肿 ， 且 当 算 法 改变 时 需要 修改 4 处 地 
方 。 而 且 也 会 增加 4 次 放 过 错误 的 可 能 性 。 

















使 用 代码 清单 3-7 中 的 include 方 法 修正 了 这 些 
重复 。 再 读 一 裔 那 段 代码， 你 会 注意 到 ， 整 个 模块 
的 可 旋 性 因为 重复 的 消除 而 得 到 了 提升 。 


重复 可 能 是 软件 中 一 切 邪 恶 的 根源 。 许 多 原则 
与 实践 规则 都 是 为 控制 与 消除 重复 而 创建 。 例 如 ， 
全 部 考 德 〈Codd) HH 数据 库 范 式 都 是 为 消灭 数据 
重复 而 服务 。 再 想 想 看 ， 面 同 对 象 编程 是 如 何 将 代 
码 集中 到 基 类 ， 从 而 避免 了 元 余 。 面 同方 面 编程 
(Aspect Oriented Programming) 、 面 向 组 件 编程 
(Component Oriented Programming) 多 少 也 都 是 消 
除 重 复 的 一 种 策略 。 看 来 ， 目 子 程序 有 友 明 以 来 ， 软 











件 开 肥 领域 的 所 有 创新 都 是 在 不 断 答 试 从 源 代码 中 
消灭 重复 。 


3.11 结构 化 编程 


有 些 程序 员 遵 循 Edsger Dijkstra 的 结构 化 编程 规 
则 [13] 。Dijkstra 认 为 ， 每 个 函数 、 函 数 中 的 每 个 代 
码 块 都 应 该 有 一 个 入 口 、 一 个 出 口 。 遵 循 这 些 规 
则 ， 意 味 看 在 每 个 水 数 中 只 该 有 一 个 return 语 句 ， 
循环 中 不 能 有 break 或 continue 语 句 ， 而 且 永 永远 远 
不 能 有 任何 goto 语 句 。 


我 们 赞成 结构 化 编程 的 目标 和 规范 ， 但 对 于 小 
函数 ， 这 些 规则 助 益 不 大 。 只 有 在 大 函数 中 ， 这 些 
规则 才 会 有 明显 的 好 处 。 


所 以 ， 只 要 函数 保持 短小 ， 人 偶尔 出 现 的 
return、break 或 continue 语 句 没 有 坏处 ， 甚 至 还 比 单 
入 单 出 原则 更 具有 表达 力 。 另 外 一 方面 ，goto 只 在 
大 函数 中 才 有 道理 ， 所 以 应 该 尽量 避免 使 用 ，。 











3.12 ”如 何 写 出 这 样 的 函数 


写 代 码 和 写 别 的 东西 很 像 。 在 与 论文 或 文章 
时 ， 你 先 想 什 么 束 写 什么 ， 然 后 再 打磨 它 。 初 稳 也 
VARMA, WEE, BAER H PH 
样子 。 


我 写 图 数 时 ， 一 开始 都 元 长 而 复杂 。 有 太 多 缩 
进 和 内 套 循环 。 有 过 长 的 参数 列表 。 名 称 是 随意 取 
的 ， 也 会 有 重复 的 代码 。 不 过 我 会 配 上 一 套 单元 测 
wi Jus HN. 


然后 我 打磨 这 些 代 码 ， 分 解 函 数 、 修 改名 称 、 
消除 重复 。 我 缩短 和 重新 安置 方法 。 有 时 我 还 拆散 
类 。 同 时 保持 测试 通过 。 


最 后 ， 尊 循 本 半 列 出 的 规则 ， 我 组 装 好 这 些 函 
数 。 


我 并 不 从 一 开始 就 按照 规则 写 函 数 。 我 想 没 人 
做 得 到 。 














3.13 ”小 结 


每 个 系统 都 是 使 用 东 种 领域 特定 语言 搭建 ， 而 
这 种 语言 是 程序 员 设 计 来 朱 述 那个 系统 的 。 函 数 是 
语言 的 动词 ， 类 是 名 词 。 这 并 非 是 退回 到 那 种 认为 
需求 文档 中 的 名 词 和 动词 就 是 系统 中 类 和 函数 的 最 
初 设想 的 可 怕 的 旧 观 念 。 其 实 这 是 个 历史 更 久 的 真 
理 。 编 程 艺 术 是 且 一 直 就 是 语言 设计 的 艺术 。 


大 师 级 程序 员 把 系统 当 作 故 事 来 讲 ， 而 个 是 当 
作 程 序 来 写 。 他 们 使 用 选 定 编程 语言 提供 的 工具 构 
建 一 种 更 为 丰富 且 更 上 其 表达 力 的 语言 ， 用 来 讲 那 个 
故事 。 那 种 领域 特定 语言 的 一 个 部 分 ， 束 是 摘 述 在 
系统 中 及 生 的 各 种 行为 的 函数 层级 。 在 一 种 狭 猎 的 
递归 操作 中 ， 这 些 行 为 使 用 它们 定义 的 与 领域 紧 冤 
相关 的 语言 讲述 自己 那个 小 故事 。 


本 章 所 讲述 的 是 有 关 编 写 民 好 函数 的 机 制 。 如 
果 你 芝 循 这 些 规则 ， 函 数 就 会 短小 ， 有 个 好 名 字 ， 
MA BREWER. AKA sid, HIE H te 
FEF BR AR EE SE MIR 63 H BR US ZL GR 
a MET SIE. TE TT) TU 
助 你 讲 故 事 。 



































3.14 ” SetupTeardownIncluder 程 序 


代码 清单 3-7 SetupTeardownIncluder.java 





package fitnesse.html; 


import fitnesse.responders.run.SuiteResponder; 
import fitnesse.wiki.*; 


public class SetupTeardownIncluder { 
private PageData pageData; 
private boolean isSuite; 
private WikiPage testPage; 
private StringBuffer newPageContent; 
private PageCrawler pageCrawler; 


public static String render(PageData pageData) throws Exceptio 


ni 


return render(pageData, false); 
} 


public static String render(PageData pageData, boolean isSuite 
) 
throws Exception { 
return new SetupTeardowniIncluder(pageData).render(isSuite); 
} 
private SetupTeardownIncluder(PageData pageData) { 
this.pageData = pageData; 
testPage - pageData.getWikiPage(); 
pageCrawler = testPage.getPageCrawler(); 
newPageContent - new StringBuffer(); 


j 


private String render(boolean isSuite) throws Exception { 
this.isSuite - isSuite; 
if (isTestPage()) 
includeSetupAndTeardownPages(); 
return pageData.getHtml(); 


j 


private boolean isTestPage() throws Exception { 
return pageData.hasAttribute("Test"); 


j 


private void includeSetupAndTeardownPages() throws Exception { 
includeSetupPages(); 
includePageContent(); 
includeTeardownPages(); 
updatePageContent(); 


j 


private void includeSetupPages() throws Exception { 
if (isSuite) 
includeSuiteSetupPage(); 
includeSetupPage(); 


j 


private void includeSuiteSetupPage() throws Exception { 
include(SuiteResponder.SUITE SETUP NAME, "-setup"); 


j 


private void includeSetupPage() throws Exception { 
include("SetUp", "-setup"); 


j 


private void includePageContent() throws Exception ( 
newPageContent.append(pageData.getContent()); 


j 


private void includeTeardownPages() throws Exception ( 
includeTeardownPage(); 
if (isSuite) 
includeSuiteTeardownPage(); 


j 


private void includeTeardownPage() throws Exception { 
include("TearDown", "-teardown"); 


j 


private void includeSuiteTeardownPage() throws Exception { 
include(SuiteResponder.SUITE TEARDOWN NAME, "-teardown"); 


j 


private void updatePageContent() throws Exception { 
pageData.setContent(newPageContent.toString()); 


j 


private void include(String pageName, String arg) throws Excep 
tion ( 
WikiPage inheritedPage = findInheritedPage(pageName) ; 
if (inheritedPage !- null) ( 
String pagePathName = getPathNameForPage(inheritedPage); 
buildIncludeDirective(pagePathName, arg); 


j 
j 


private WikiPage findInheritedPage(String pageName) throws Exc 
eption ( 
return PageCrawlerImpl.getInheritedPage(pageName, testPage); 


j 


private String getPathNameForPage(WikiPage page) throws Except 
ion ( 
WikiPagePath pagePath - pageCrawler.getFullPath(page); 
return PathParser.render(pagePath); 


} 
private void buildIncludeDirective(String pagePathName, String 
arg) { 
newPageContent 
.append("\n!include ") 
.append(arg) 
.append(" .") 
.append(pagePathName) 
.append(" n"); 
} 
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[2] JRE: 一 种 开源 Java 单 元 测试 工具 。 见 





http:/www.junit.org o 


[B] JRE: 我 问 肯特 是 否 还 保留 这 段 程 序 ， 他 说 
找 不 到 了 。 我 搜 遍 自己 的 电脑 也 没 找 到 。 现 在 只 有 
在 记忆 中 有 这 段 程序 了 。 

[4] Jit: LOGO 语 言 中 的 TO 关键 字 ， 与 Ruby 和 
Python 中 def 关 键 字 的 用 法 一 致 。 所 以 ， 每 个 函数 都 
以 TO 起 头 。 这 对 函数 的 设计 产生 了 有 趣 的 影 啊 。 
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[6] E: 当然 ， 这 也 包括 if/else 语 句 在 内 。 
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http://en.wikipedia.org/wiki/Open/closed principle ; 
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[] ” 原 注 : [GOF]. 


[10] JRE: 我 刚 重 构 了 一 个 使 用 了 二 元 形式 的 模 
块 。 现 在 就 能 把 outputStream 做 成 该 类 的 一 个 字 

段 ， 并 把 所 有 对 writeField 的 调用 都 变 作 一 元 形式 。 
ARMUT I. 


[11] JRE: 那些 以 为 可 以 不 重新 编 详 和 部 普 融 扬 
KMD A AKA AB EER 


[12] JRE: 这 也 是 开放 闭合 原则 (OCP) 的 一 个 
范例 [PPP02]。 








[13] JE}: DRY). [PRAG]. 


[14] 译注: XÆ F- #4 (Edgar F. Codd) , 
关系 数据 库 之 父 。 


[15] Jey: [SP72]. 


"CRANE ”注释 





«| ZA SURE ER] FG JD GERE — 重新 写 吧 。” 
— Brian W. Kernighan P. J. Plaugher lH 


什么 也 比 不 上 放置 展 好 的 注释 来 得 有 用 。 什 么 
也 不 会 比 乱 七 八 糟 的 注释 更 有 本 事 搞 乱 一 个 模块 。 
什么 也 不 会 比 陈 旧 、 提 供 错误 信息 的 注释 更 有 破坏 
HE. 


TERE FF AMR AE TOIT] EMTS AS EDAX 
Wf". KEE, VERS ite oH 
编程 语言 足够 有 表达 力 ， 或 者 我 们 长 于 用 这 些 语言 
来 表达 意图 ， 束 不 那么 需要 注释 一 一 也 许 根 本 不 需 
HH 


Xo 











注释 的 恰当 用 法 是 弥补 我 们 在 用 代码 表达 意图 
时 遭 过 的 失败 。 注 意 ， 我 用 了 “失败 ”一 词 。 我 是 说 
真 的 。 注 释 总 是 一 种 失败 。 我 们 总 无 法 找到 不 用 注 
释 就 能 表达 上 自我 的 方法 ， 所 以 总 要 有 注释 ， 这 并 不 
值得 庆 资 。 











办 法 翻盘 ， 用 代码 来 表达 。 每 次 用 代码 表达 ， 你 都 
该 从 炎 一 下 目 己 。 每 次 写 注 释 ， 你 都 该 做 个 鬼脸 ， 
感受 目 己 在 表达 能 力 上 的 失败 。 


我 为 什么 要 极力 凤 低 注释 ? 因为 注释 会 撤 说 。 
也 不 是 说 总 是 如 此 或 有 意 如 此 ， 但 出 现 得 实在 太 频 
楷 。 注 释 存 在 的 时 间 越 入， 束 离 其 所 描述 的 代码 越 
远 ， 越 来 越 变 得 全 然 错误 。 原 因 很 简单 。 程 序 员 不 
能 坚持 维护 注释 。 


代码 在 变动 ， 在 演化 。 从 这 里 移 到 那里 。 彼 此 
分 离 、 重 造 又 合 到 一 处 。 很 不 侍 ， 注 释 并 不 总 是 随 
之 变动 一 一 不 能 AEE AE. TER Hae IEP 
描述 的 代码 分 隔 开 来 ， 子 然 飘 零 ， 越 来 越 不 准确 。 
例如 ， 看 看 以 下 注释 以 及 它 本 来 要 描述 的 代码 行 变 
成 了 什么 样子 : 





























MockRequest request; 

private final String HTTP DATE REGEXP - 
"[SMTWF][a-z] (213 NN, NNs[0-9] (22 NN S[JFMASOND] [a-z]{2}\\s"+ 
"[0-9](4) NNs[0-9] (237 NN: [0-9] (212 NN : [0-9] {2}\\SGMT"; 


private Response response; 

private FitNesseContext context; 

private FileResponder responder; 

private Locale saveLocale; 

// Example: "Tue, 02 Apr 2003 22:18:49 GMT" 





在 HTTP DATE REGEXP 常 量 及 其 注释 之 间 ， 
有 可 能 插入 其 他 实体 变量 。 


程序 员 应 当 人 负责 将 注释 保持 在 可 维护 、 有 关 
联 、 精 确 有 的 蜗 度 。 我 同音 这 种 说 法 。 但 我 更 主张 把 
力气 用 在 写 清楚 代码 上 ， 直 接 保证 无 须 编 写 注 释 。 





不 准确 的 注释 要 比 没 注释 坏 得 多 。 它 们 满口 胡 
言 。 它 们 预期 的 东西 永 不 能 实现 。 它 们 设 定 了 无 需 
也 不 应 再 遵循 的 旧 规则 。 


真实 只 在 一 处 地 方 有 : 代码 。 只 有 代码 能 忠实 
地 告诉 你 它 做 的 事 。 那 是 唯一 真正 准确 的 信息 来 
源 。 所 以 ， 尺 省 有 时 也 需要 注释 ， 我 们 也 该 多 花心 


ES VAD TE REE 


4.1 注释 不 能 去 化 糖 糙 的 代 抬 


写 注释 的 毅 见 动机 之 一 是 糟糕 的 代码 的 存在 。 
我 们 编写 一 个 模块 ， 发 现 它 令 人 人 困扰、 乱七八糟 。 
RIIIE, CEES. RIEA: “We, wU 
写 扩 注释 ! ”不 ! elif EEA ! 


市 有 少量 注释 的 整 少 而 有 表达 力 的 代码 ， 要 比 
市 有 大 量 注释 的 零 俯 而 复杂 的 代码 像样 得 多 。 与 其 
化 时 间 编 与 解释 你 摘出 的 粳 糙 的 代码 的 注释 ， 不 如 
AGEN TA) Yes Yes AK HE EE CAS o 





4.2 ”用 代码 来 阐述 


有 了 时， 代码 本 号 不 足以 解释 其 行为 。 不 六 的 
是 ， 许 多 程序 员 据 此 以 为 代码 很 少 一 一 如 果 有 的 话 














能 做 好 解释 工作 。 这 种 观点 纯 属 错误 。 你 愿意 
看 到 这 个 : 


// Check to see if the employee is eligible for full benefits 
if ((employee.flags & HOURLY FLAG) && 
(employee.age » 65)) 





还 是 这 个 ? 


if (employee.isEligibleForFullBenefits()) 


只 要 想 上 那么 几 秒 钟 ， 就 能 用 代码 解释 你 大 部 
分 的 意图 。 很 多 时 候 ， 简 单 到 只 需要 创建 一 个 描述 
与 注释 所 言 同一 事物 的 函数 即 可 。 





4.3 ”好 注释 

有 些 注释 是 必须 的 ， 也 是 有 利 的 。 来 看 看 一 些 
我 认为 值得 写 的 注释 。 不 过 要 记 住 ， 唯 一 真正 好 的 
注释 是 你 想 办 法 不 去 写 的 注释 。 

















4.3.1 法律 信息 


有 时 ， 公 司 代码 规范 要 求 编写 与 法 律 有 关 的 注 
释 。 例 如 ， 版 权 及 著作 权 声 明 就 是 必须 和 有 理由 在 
每 个 源 文件 开头 注释 处 放置 的 内 容 。 

下 例 是 我 们 在 FitNesse 项 目 每 个 源 文 件 开 头 放 
置 的 标准 注释 。 我 可 以 很 开心 地 说 ，IDE 目 动 卷 起 


这 些 注 释 ， 这 样 束 不 会 显得 竣 乱 了 。 














// Copyright (C) 2003,2004,2005 by Object Mentor, Inc. All righ 
ts reserved. 
// Released under the terms of the GNU General Public License v 


ersion 2 or later. 








这 类 注释 不 应 是 合同 或 法 典 。 只 要 有 可 能 ， 惑 
指 同 一 份 标准 许可 或 其 他 外 部 文档 ， 而 不 要 把 所 有 
条 球 放 到 注释 中 。 


4.3.2 ”提供 信息 的 注释 


有 时 ， 用 注释 来 提供 基本 信息 也 有 其 用 处 。 例 
如 ， 以 下 注释 解释 了 示 个 抽象 方法 的 返回 值 : 





// Returns an instance of the Responder being tested. 


protected abstract Responder responderInstance(); 














这 类 注释 有 时 管用 ， 但 更 好 的 方式 是 尽量 利用 
国 数 名 称 传达 信息 。 比 如 ， 在 本 例 中 ， 只 要 把 函数 
重新 命名 为 responderBeingTested， 注 释 束 是 多 余 的 
Jx 





// format matched kk:mm:ss EEE, MMM dd, yyyy 
Pattern timeMatcher - Pattern.compile( 
"NNd* :NNd* :NNd* \\w*, \\w* NNd*, \Ad*"); 





在 本 例 中 ， 注 释 说 明 ， 该 正则 表达 式 意 在 风 配 
一 个 经 由 SimpleDateFormat.format 函 数 利 用 特定 格 





式 字符 串 格式 化 的 时 间 和 上 日期。 同样 ， 如 果 把 这 上 段 
代码 移 到 某 个 转换 日 期 和 时 间 格 式 的 类 中 ， 就 会 更 





好 、 更 清晰 ， 而 注释 也 就 变 得 多 此 一 举 了 。 
4.3.8. 对 意图 的 解释 


有 时 ， 注 释 不 仅 提供 了 有 关 实 现 的 有 用 信息 ， 
而 且 还 提供 了 某 个 决定 后 面 的 意图 。 在 下 例 中 ， 我 
们 看 到 注释 反映 出 来 的 一 个 有 趣 决 定 。 在 对 比 两 个 
ae ee mene eee an 
Y AL ò 








public int compareTo(Object o) 
if(o instanceof WikiPagePath) 
WikiPagePath p - (WikiPagePath) o; 
String compressedName = StringUtil.join(names, ""); 


String compressedArgumentName - StringUtil.join(p.names, "") 


return compressedName.compareTo(compressedArgumentName); 


return 1; // we are greater because we are the right type. 








下 面 的 例子 甚至 更 好 。 你 也 许 不 同意 程序 员 给 
这 个 问题 提供 的 解决 方案 ， 但 至 少 你 知道 他 想 干 什 


o 


public void testConcurrentAddWidgets() throws Exception { 


六 


WidgetBuilder widgetBuilder = 
new WidgetBuilder(new Class[]{BoldWidget.class}); 


String text = "'''bold text'''"; 
ParentWidget parent - 
new Boldwidget(new MockWidgetRoot(), "'''bold text'''"); 


AtomicBoolean failFlag - new AtomicBoolean(); 
failFlag.set(false); 


//This is our best attempt to get a race condition 
//by creating large number of threads. 


for (int i = 0; i < 25000; i++) { 
WidgetBuilderThread widgetBuilderThread = 
new WidgetBuilderThread(widgetBuilder, text, parent, failF 
lag); 
Thread thread - new Thread(widgetBuilderThread); 
thread.start(); 


} 
assertEquals(false, failFlag.get()); 
} 





4.3.4 阐释 


4m, SEE uen x8] mz Sk I fei Erg 
意义 翻译 为 菜 种 可 读 形 式 ， 也 会 是 有 用 的 。 通 和 党， 
更 好 的 方法 是 尽量 让 大 数 或 返回 值 自身 就 是 人 请 
; 但 如 果 参 数 或 返回 值 是 某 个 标准 库 的 一 部 分 ， 
Aio 能 修改 的 代码 ， 帮 助 阐释 其 含义 的 代码 就 
会 有 用 。 


public void testCompareTo() throws Exception 


WikiPagePath a - PathParser.parse("PageA"); 
WikiPagePath ab - PathParser.parse("PageA.PageB"); 
WikiPagePath b - PathParser.parse("PageB"); 
WikiPagePath - PathParser.parse("PageA.PageA"); 
WikiPagePath - PathParser.parse("PageB.PageB"); 
WikiPagePath - PathParser.parse("PageB.PageA"); 
assertTrue(a.compareTo(a) -- 0); //a--a 
assertTrue(a.compareTo(b) !- 0); // a !- b 


assertTrue(ab.compareTo(ab) == 0); // ab -- ab 
assertTrue(a.compareTo(b) == -1); //a«b 

assertTrue(aa.compareTo(ab) == -1); // aa < ab 
assertTrue(ba.compareTo(bb) == -1); // ba < bb 
assertTrue(b.compareTo(a) == 1); //b»a 

assertTrue(ab.compareTo(aa) == 1); // ab > aa 
assertTrue(bb.compareTo(ba) == 1); // bb > ba 





TAN, X B HRE ETE BAS LS IE TATE XU 
EE. KBE EB, MRAMA EREK IE 
性 有 多 难 。 这 一 方面 说 明了 阐释 有 多 必要 ， 为 外 也 
说 明了 它 有 风险 。 所 以 ， 在 写 这 类 注释 之 前 ， 考 虑 
一 下 是 人 否 还 有 更 好 的 办 法 ， 然 后 再 加 倍 小 心地 确认 
注释 正确 性 。 





4.3.5 ”警示 


有 时 ， 用 于 警告 其 他 程序 员 会 出 现 茶 种 后 果 的 
注释 也 是 有 用 的 。 例 如 ， 下 面 的 注释 解释 了 为 什么 
要 关 财 条 个 特定 的 测试 用 例 : 








// Don't run unless you 


// have some time to kill. 


public void _testWithReallyBigFile() 
t 


writeLinesToFile(10000000); 


response.setBody(testFile); 

response.readyToSend(this); 

String responseString - output.toString(); 
assertSubString("Content-Length: 1000000000", responseString); 
assertTrue(bytesSent » 1000000000); 








当然 ， 如 今 我 们 多 数 会 利用 附 上 恰当 解释 性 字 
符 串 的 @Ignore 属 性 来 关闭 测试 用 例 。 比 如 
(2Ignore("Takes too long to run ^1 "), {AZEJUNIt4Z 
前 的 日 子 里 ， 人 惯常 的 做 法 是 在 方法 名 前 面 加 上 下 划 
线 。 如 果 注 释 足 够 有 说 服 力 ， 束 会 很 有 用 了 。 


这 里 有 个 更 砍 烦 的 例子 : 


public static SimpleDateFormat makeStandardHttpDateFormat() 
i 


//SimpleDateFormat is not thread safe, 


//so we need to create each instance independently. 


SimpleDateFormat df = new SimpleDateFormat("EEE, dd MMM yyyy 
HH:mm:ss z"); 

df.setTimeZone(TimeZone.getTimeZone("GMT")); 

return df; 


3 








MEFFRE, Rae AURIS. R 
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4.3.6 TODO 注 释 


有 时 ， 有 理由 用 /TODO 形 式 在 源 代码 中 放置 
要 做 的 工作 列表 。 在 下 例 中 ，TODO 注 释 解释 了 为 
gon m 








//TODO-MdM these are not needed 


// We expect this to go away when we do the checkout model 


protected VersionInfo makeVersion() throws Exception 


{ 
return null; 





TODO — FIRE A NMZ TELE FRE 





原因 目前 还 没 做 的 工作 。 它 可 能 是 要 提醒 删除 某 个 
不 必要 的 特性 ， 或 者 要 求 他 人 注意 某 个 问题 。 它 可 
能 是 恳请 别人 取 个 好 名 字 ， 或 者 提示 对 依赖 于 某 个 
计划 事件 的 修改 。 无 论 TODO 的 目的 如 何 ， 它 都 不 
是 在 系统 中 留 下 糟糕 的 代码 的 借口 。 

如 今 ， 大 多 数 好 IDE 都 提供 了 特别 的 手段 来 定 
位 所 有 TODO 注 释 ， 这 些 注释 看 来 于 不 了 。 你 不 会 
愿意 代码 因为 TODO 的 存在 而 变 成 一 堆 垃圾 ， 所 以 
要 定期 查看 ， 删 除 不 再 需要 的 。 


4.3.7 放大 
注释 可 以 用 来 放大 某 种 看 来 不 合理 之 物 的 重要 











String listItemContent = match.group(3).trim(); 
// the trim is real important. It removes the starting 


// spaces that could cause the item to be recognized 


// as another list. 


new ListItemWidget(this, listItemContent, this.level + 1); 
return buildList(text.substring(match.end())); 





4.3.8 ”公共 API 中 的 Javadoc 





没有 什么 比 被 展 好 描述 的 公共 API 更 有 用 和 令 
人 满意 的 了 。 标 准 Java 库 中 的 Javadoc 束 是 一 例 。 没 
有 它们 ， 写 Java 程 序 束 会 变 得 很 难 。 











如 下 你 在 编写 公共 API， 就 该 为 它 编 写 民 好 的 
Javadoc。 不 过 要 记 住 本章 中 的 其 他 建议 。 束 像 其 他 
注释 一 样 ，Javadoc 也 可 能 误导 、 不 适用 或 者 提供 钳 
误 信 息 。 











AA TIER 


大 多 数 注释 都 属 此 类 。 通 常 ， 坏 注释 都 是 糟糕 
的 代码 的 支撑 或 谷口 ， 或 者 对 错误 决 东 的 修正 ， 基 
本 上 等 于 程序 员 目 说 目 话 。 











4.4.1 FS E] iE 


AR R Xe SLOTS SCA Bor DSL SURE rm ES 
添加 注释 ， 那 就 是 无 谓 之 举 。 如 果 你 决定 写 注 释 ， 
就 要 人 花 必要 的 时 间 确 保 写 出 最 好 的 注释 。 

例如 ， 我 在 FitNesse 中 找到 的 这 个 例子 ， 例 中 


的 注释 大 概 确实 有 用 。 不 过 ， 作 者 太 着 急 ， 或 者 没 
太 伦 心思 。 他 的 喃 喃 自 语 变 成 了 一 个 谈 团 。 











public void loadProperties() 


try 


String propertiesPath = propertiesLocation + "/" + PROPERTIE 
S FILE; 

FileInputStream propertiesStream - new FileInputStream(prope 
rtiesPath); 

loadedProperties.load(propertiesStream); 


} 
catch(IOException e) 
{ 


// No properties files means all defaults are loaded 








catch 代 码 块 中 的 注释 是 什么 意思 呢 ? 显然 对 于 
作者 有 其 意义 ， 不 过 并 没有 好 到 足够 的 程度 。 很 明 
显 ， 如 果 出 现 IOException， 束 表示 没有 属性 文件 ; 
在 那 种 情况 下 ， 载 入 默认 设置 。 但 谁 来 装载 默认 设 
置 呢 ? 会 在 对 loadProperties.load 之 前 装载 吗 ? 抑或 
loadProperties.load 捕 获 异 常 、 装 载 默 认 设 置 、 再 问 
上 传递 异常 ? 再 或 loadProperties.load 在 尝试 载 入 文 
件 前 就 装载 所 有 默认 设置 ? 要 么 作者 只 是 在 安慰 自 
己 别 在 意 catch 代 人 码 块 的 留 空 ?或 者 一 一 这 种 可 能 最 
Ay Hf 作者 是 想 告 诉 目 己 ， 将 来 再 回头 写 装 载 默 
Wu BB? 


我 们 唯 有 检视 系统 其 他 部 分 的 代码 ， 弄 清 事情 
原委 。 任 何 迫 使 读者 碍 看 其 他 模块 的 注释 ， 都 没 能 
与 谈 者 沟通 好 ， 不 值 所 灾 。 


44.2 多余 的 注释 

代码 清单 41 展 示 的 简单 函数 ， 其 头 部 位 置 的 
注释 全 属 多 余 。 读 这 段 注释 伦 的 时 间 没 准 比 读 代 码 
化 的 时 间 还 要 长 。 



































代码 清单 4-1  waitForClose 


// Utility method that returns when this.closed is true. Throws 
an exception 


// if the timeout is reached. 
public synchronized void waitForClose(final long timeoutMillis) 


throws Exception 


if(!closed) 


wait(timeoutMillis); 
if(!closed) 
throw new Exception("MockResponseSender could not be close 


d"); 
} 
) 





这 上 段 注 释 起 了 什么 作用 ? 它 并 不 能 比 代码 本 里 
提供 更 多 的 信息 。 它 没有 证 明代 码 的 意义， 也 没有 
给 出 代码 的 意图 或 逻辑 。 读 它 并 不 比 读 代 码 更 容 
易 。 事 实 上 ， 它 不 如 代码 精确 ， 误 导读 者 接受 不 精 
确 的 信息 ， 而 不 是 正确 地 理解 代码 。 它 就 像 个 自 来 
FAN] FAIS. Wi HAERA ST ROA Ltt 


JS. 




















来 看 看 代码 清单 4-2 中 摘自 Tomcat 项 目的 无 用 


而 多 余 的 Javadoc 吧 。 这 些 注释 只 是 一 味 将 代码 搞 得 
含糊 不 明 。 完 全 没有 文档 上 的 价值 。 下 面 只 列 出 了 
靠 前 面 的 一 些 代码 ， 后 续 模块 中 还 有 许多 类 似 情 
s. 


代码 清单 4-2 ContainerBase.java (Tomcat) 





public abstract class ContainerBase 
implements Container, Lifecycle, Pipeline, 
MBeanRegistration, Serializable ( 


/** 
* The processor delay for this component. 
d 

protected int backgroundProcessorDelay - -1; 


LER 
* The lifecycle event support for this component. 
*/ 

protected LifecycleSupport lifecycle = 
new LifecycleSupport(this); 


/** 
* The container event listeners for this Container. 
*/ 

protected ArrayList listeners = new ArrayList(); 


/** 
* The Loader implementation with which this Container is 
* associated. 
*/ 

protected Loader loader = null; 


JER 
* The Logger implementation with which this Container is 
* associated. 
*/ 

protected Log logger = null; 


J ER 
* Associated logger name. 


*/ 
protected String logName = null; 


/** 
* The Manager implementation with which this Container is 
* associated. 
*/ 

protected Manager manager = null; 


SEXK 
* The cluster with which this Container is associated. 
* 

protected Cluster cluster = null; 


JEX 
* The human-readable name of this Container. 
*/ 

protected String name = null; 


yee 
* The parent Container to which this Container is a child. 
*/ 

protected Container parent = null; 


JAX 
* The parent class loader to be configured when we install a 
* Loader. 
*/ 

protected ClassLoader parentClassLoader = null; 


/** 
* The Pipeline object with which this Container is 
* associated. 
*/ 
protected Pipeline pipeline = new StandardPipeline(this); 


LER 
* The Realm with which this Container is associated. 
a A 

protected Realm realm = null; 


JEK 
* The resources DirContext object with which this Container 
* is associated. 
*/ 


protected DirContext resources - null; 


4.4.3 ”误导 性 注释 


Aly, RW Se, REP Bee in Mes 
精确 的 注释 。 想 想 看 代码 清单 4-1 中 那 多 余 而 又 有 
误导 嫌疑 的 注释 吧 。 


你 有 没有 发 现 那样 的 注释 是 如 何 误导 读者 的 ? 
在 this.closed 变 为 true 的 时 候 ， 方 法 并 没有 返回 。 方 
法 只 在 判断 到 this.closed 为 true 的 时 候 返 回 ， 人 否则 ， 
LR ee PRE TC AEN, Aa On FAL T 
this.closed 还 是 非 true， 就 抛 出 一 个 异常 。 


这 一 细微 的 误导 信息 ， 放 在 比 代 人 码 本 里 更 难 阅 
谈 的 注释 里 面 ， 有 可 能 导致 其 他 程序 员 快 活 地 调用 
这 个 函数 ， 并 期 望 在 this.closed 变 为 true 时 立即 返 
回 。 那 位 可 怜 的 程序 员 将 会 发 现 目 己 陷于 调试 困境 
之 中 ， 拼 命 想 找 出 代码 执行 得 如 此 之 慢 的 原因 。 

















AAA 循 规 式 注释 


所 谓 每 个 函数 都 要 有 Javadoc 或 每 个 变量 都 要 有 
注释 的 规矩 全 然 是 昌黎 可 笑 的。 这 类 注释 徒然 让 代 
码 变 得 散乱 ， 满 口 胡 言 ， 令 人 迷惑 不 解 。 


例如 ， 要 求 每 个 函数 都 要 有 Javadoc， 束 会 得 到 
类 似 代 人 码 清 单 4-3 那 样 面目 可 习 的 代码 。 这 类 废话 
只 会 搞 乱 代码 ， 有 可 能 误导 读者 。 


代码 清单 4-3 


Qparam title The title of the CD 
@param author The author of the CD 
Qparam tracks The number of tracks on the CD 
@param durationInMinutes The duration of the CD in minutes 
rA 
public void addCD(String title, String author, 
int tracks, int durationInMinutes) { 


CD cd - new CD(); 
cd.title - title; 
cd.author - author; 
cd.tracks - tracks; 
cd.duration - duration; 
cdList.add(cd); 





44.5 日 志 式 注释 


有 人 会 在 每 次 编辑 代码 时 ， 在 模块 开始 处 添加 
一 条 注释 。 这 类 注释 束 像 古 一 种 记录 每 次 修改 的 日 
志 。 我 见 过 满 岛 尽 是 这 类 日 志 的 代码 模块 。 





* Changes (from 11-Oct-2001) 
* 


* 11-Oct-2001 : Re-organised the class and moved it to new pack 
age 
* com.jrefinery.date (DG); 


* 05-Nov-2001 : 


NotableDate 
* 


* 12-Nov-2001 : 


NotableDate 


* 


DE 


() to correct 
* 


* 05-Dec-2001 : 
* 29-May-2002 : 


face 


* 


* 27-Aug-2002 : 


Added a getDescription() method, and eliminated 


class (DG); 
IBD requires setDescription() method, now that 


class is gone (DG); Changed getPreviousDayOfWee 


getFollowingDayOfWeek() and getNearestDayOfWeek 


bugs (DG); 
Fixed bug in SpreadsheetDate class (DG); 
Moved the month constants into a separate inter 


(MonthConstants) (DG); 


Fixed bug in addMonths() method, thanks to N??? 


levka Petr (DG); 


* 03-Oct-2002 


avadocs (DG); 


* 05-Jan-2005 : 


: Fixed errors reported by Checkstyle (DG); 
* 13-Mar-2003 : 
* 29-May-2003 : 
* 04-Sep-2003 : 


Implemented Serializable (DG); 
Fixed bug in addMonths method (DG); 
Implemented Comparable. Updated the isInRange j 


Fixed bug in addYears() method (1096282) (DG); 





很 久 以 前 ， 在 模块 开始 处 创建 并 维护 这 些 记录 
还 和 舞 有 道理 。 屠 时， 我 们 还 没有 源 代 人 码 控制 系统 可 


用 。 如 今 ， 


这 种 元 长 的 记录 只 会 让 模块 变 得 凑 乱 不 


堪 ， 应 当 全 部 删除 。 


4.4.6 ”废话 注释 


有 时 ， 你 会 看 到 纯 然 是 废话 的 注释 。 它 们 对 于 
显然 之 事 唆 喉 不 休 ， 毫 无 新 意 。 


fre 
* Default constructor. 





*/ 
protected AnnualDateRule() { 








对 吧 ? 再 看 看 这 个 : 


/** The day of the month. */ 
private int dayOfMonth; 


还 有 这 样 的 废话 模范 : 
/** 
* Returns the day of the month. 
* Qreturn the day of the month. 
*/ 


public int getDayOfMonth() { 
return dayOfMonth; 


j 








这 类 注释 废话 连篇 ， 我 们 都 学 会 了 视而不见 。 
读 代 码 时 ， 眼 光 不 会 停留 在 它们 上 面 。 最 终 ， 当 代 
人 码 修改 之 后 ， 这 类 注释 就 变 作 了 诉 言 一 堆 。 


代码 清单 4-4 中 的 第 一 条 注释 貌似 还 行 DI, E 
解释 了 catch 代 码 块 为 何 被 忽略 。 不 过 第 二 条 注释 束 
纯 是 废话 了。 显然 ， 访 程序 员 泪 形 于 编写 函数 中 那 
些 try/catch 代 码 块 。 





代码 清单 4-4 startSending 


private void startSending() 


{ 
try 
doSending(); 


catch(SocketException e) 


// normal. someone stopped the request. 


catch(Exception e) 


{ 
try 


{ 


response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 


catch(Exception e1) 


// Give me a break! 





与 其 纠缠 于 坚 无 价值 的 废话 注释 ， 程 序 员 应 该 
意识 到 ， 他 的 挫败 感 可 以 由 改进 代码 结构 而 消除 。 
他 应 该 把 力气 花 在 将 最 末 一 个 try/catch 代 人 码 块 拆 解 
到 单独 的 函数 中 ， 如 代码 清单 4-5 所 示 。 





代码 清单 4-5 startSending 〈 重 构 之 后 ) 


private void startSending() 


{ 
try 


doSending(); 
catch(SocketException e) 
: //normal. someone stopped the request. 
catch(Exception e) 
addExceptionAndCloseResponse(e); 


j 
j 


private void addExceptionAndCloseResponse(Exception e) 
t 
try 
{ 
response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 


catch(Exception e1) 





HIE SEALS B Deb SN BIS DU) SPIEL. YK 
会 发 现 目 己 成 为 更 优秀 、 更 快乐 的 程序 员 。 


4.4.7 ”可 怕 的 废话 
Javadoc 也 可 能 是 废话 。 下 列 Javadoc CE ELA: 








知名 开源 库 ) 的 目的 是 什么 ? 答案 : 无 。 它 们 只 是 
源 目 某 种 提供 文档 的 不 当 愿 望 的 废话 注释 。 





name. */ 
String name; 


version. */ 
String version; 


licenceName. */ 
String licenceName; 


version. */ 
String info; 








FF ABS ea EEE ffoi t AUT BIW) 
贴 错误 ?如果 作 者 在 写 〈 或 粘贴 ) 注释 时 都 没 花 心 
思 ， 怎 么 能 指望 读者 从 中 获 共 呢 ? 
4.4.8 ”能 用 函数 或 变量 时 束 别 用 注释 

看 看 以 下 代码 概要 : 











// does the module from the global list <mod> depend on the 
// subsystem we are part of? 
if (smodule.getDependSubsystems().contains(subSysMod.getSubSyst 


em())) 





可 以 改 成 以 下 没有 注释 的 版 本 : 


ArrayList moduleDependees = smodule.getDependSubsystems(); 
String ourSubSystem = subSysMod.getSubSystem( ); 


if (moduleDependees.contains(ourSubSystem)) 








代码 原作 者 可 能 (不 太 像 ) 是 先 写 注释 再 编写 
代码 。 不 过 ， 作 者 应 该 重 构 代码 ， 如 我 所 做 的 那 
样 ， 从 而 删 挥 注释 。 








44.9 jr Bi 


有 时 ， 程 序 员 喜 欢 在 源 代码 中 标记 某 个 特别 位 
置 。 例 如 ， 最 近 我 在 程序 中 看 到 这 样 一 行 : 


// Actions /LALLALALALALALALALALALALALALALALALALALALALALALALALALAALAAAA 


把 特定 函数 征 放 在 这 种 标记 栏 下面 ， 多 数 时 候 
实 属 无 理 。 鸡 去 狗 碎 ， 理 当 删 除 一 一 特别 是 尾部 那 
TR BTC HRA.» 


这 么 说 吧 。 如 果 标 记 栏 不 多 ， 就 会 显而易见 ， 
所 以 ， 尽 量 少 用 标记 栏 ， 只 在 特别 有 价值 的 时 候 
用 。 如 果 洲 用 标记 栏 ， 就 会 沉没 在 背景 噪音 中 ， 被 
忽略 掉 。 


4.4.10 ”括号 后 面 的 注释 














有 时 ， 程 序 员 会 在 括号 后 面 放置 特殊 的 注释 ， 
如 代码 清单 4- 6 所 不 。 尽管 这 对 于 含有 REMEM 
构 的 长 函数 可 能 有 意义 ， 但 只 会 给 我 们 更 愿意 编 
的 短小 、 封 痛 的 函数 带 来 混乱 。 如 果 你 发 现 自己 起 
标记 右 括 号 ， 其 实 应 该 做 的 是 缩短 函数 。 


代码 清单 4-6 wc.java 











public class wc { 
public static void main(String[] args) { 
BufferedReader in - new BufferedReader(new InputStreamReader 
(System.in)); 
String line; 


int lineCount - 0; 
int charCount - 0; 
int wordCount - 0; 
try { 
while ((line - in.readLine()) !- null) ( 
lineCount++; 


charCount += line.length(); 
String words[] = line.split("NNw"); 
wordCount += words.length; 

} //while 


" + wordCount ) ; 
" + lineCount); 
" + charCount); 


System.out.printin("wordCount 
System.out.println("lineCount 
System.out.println("charCount 
// try 


tw 


catch (I0Exception e) { 
System.err.println("Error:" + e.getMessage()); 
) //catch 


) //main 


BEEN UO 
4431 JH 584 


/* Added by Rick */ 


UN Rat t Ze RIE E E T lO CE ee VETE AT IRE S JH 
了 什么 。 没 必要 用 那些 小 小 的 签名 摘 脏 代码 。 你 也 
许 会 认为 ， 这 种 注释 大 概 有 助 于 他 人 了 解 应 该 和 谁 
讨论 这 段 代 码 。 不 过 ， 事 实 却 是 注释 在 那儿 放 了 一 
I onem 


重申 一 下 ， 源 代码 控制 系统 是 这 类 信息 最 好 的 
归属 地 。 


4.4.12 ”注释 控 的 代码 
直接 把 代码 注释 掉 是 讨厌 的 做 法 。 别 这 么 干 ! 





InputStreamResponse response = new InputStreamResponse(); 
response.setBody(formatter.getResultStream(), formatter.get 
ByteCount()); 
//  InputStream resultsStream = formatter.getResultStream(); 


//  StreamReader reader = new StreamReader(resultsStream); 


//  response.setContent(reader.read(formatter.getByteCount())); 





其 他 人 不 敢 删 除 注 释 挥 的 代码 。 他 们 会 想 ， 代 
码 依 然 放 在 那儿 ， 一 定 有 其 原因 ， 而 且 这 上段 代码 很 
午 要 ， 不 能 和 删除。 注释 挥 的 代码 堆积 在 一 起 ， 刺 像 
AS TPA HES B] E 8E — BX e 





看 看 以 下 来 自 Apache 公 共 库 的 代码 : 





this.bytePos = writeBytes(pngIdBytes, 0); 
//hdrPos - bytePos; 


writeHeader(); 
writeResolution(); 
//dataPos - bytePos; 


if (writelmageData()) { 
writeEnd(); 


this.pngBytes - resizeByteArray(this.pngBytes, this.maxPos); 


else( 
this.pngBytes-null; 
} 


return this.pngBytes; 


p 


这 两 行 代码 为 什么 要 注释 挥 ? 它们 重要 吗 ? E 
们 搁 在 那儿 ， 是 为 了 给 未 来 的 修改 做 提示 吗 ? 或 
者 ， 只 是 尔 人 在 多 年 以 前 注释 挥 、 懒 得 清理 的 过 时 


玩意 ? 


20 世 纪 60 年 代 ， 曾 经 有 那么 一 段 时 间 ， 注 释 掉 
的 代码 可 能 有 用 。 但 我 们 已 经 拥有 优良 的 源 代码 控 
制 系统 如 此 之 久 ， 这 些 系统 可 以 为 我 们 记 住 不 要 的 
代码 。 我 们 无 需 再 用 注释 来 标记 ， 删 掉 即 可 ， 它 们 
于 不 了 。 我 担保 。 





4.4.13 HTML 注释 


源 代码 注释 中 的 HTML 标 记 是 一 种 大 物 ， 如 你 
在 下 面 代码 中 所 见 。 编 辑 器 /IDE 中 的 代码 本 来 易于 
阅读 ， 却 因为 HTML 注 释 的 存在 而 变 得 难以 从 读 。 
如 果 注 释 将 由 某 种 工具 (例如 Javadoc) 抽取 出 来 ， 
呈现 到 网 页 ， 那 么 该 是 工具 而 非 程序 员 来 负责 给 注 
释 加 上 合适 的 HTML 标 签 。 














* Task to run fit tests. 

* This task runs fitnesse tests and publishes the results. 
* <p/> 

* <pre> 

* Usage: 


&lt;taskdef name=&quot;execute-fitnesse-tests&quot; 
classname-&quot;fitnesse.ant.ExecuteFitnesseTestsTask&quo 


+ + 


classpathref=&quot;classpath&quot; /&gt; 

OR 

&lt;taskdef classpathref=&quot;classpath&quot; 

resource=& quot; tasks.properties&quot; /&gt; 

<p/> 

&lt;execute-fitnesse-tests 
suitepage-&quot;FitNesse.SuiteAcceptanceTests&quot; 
fitnesseport-&quot;8082&quot; 
resultsdir=&quot;${results.dir}&quot; 
resultshtmlpage-&quot;fit-results.html&quot; 
classpathref-&quot;classpath&quot; /&gt; 

</pre> 


+ + ok OR + FF OR Ob HF HF HF HM 


dU 





4.4.14 ” 非 本 地 信息 


假如 你 一 定 要 写 注 释 ， 请 确保 它 接 述 了 离 它 
近 的 代码 。 别 在 本 地 ERAT IDA ANE 
级 的 信息 。 以 下 面 的 Javadoc 注 释 为 例 ， 除 了 那 可 怕 
的 元 余 之 外 ， 它 还 给 出 了 有 关 默 认 端 口 的 信息 。 不 
过 该 函数 完全 没 控制 到 那个 所 谓 默 认 值 。 这 个 注释 
并 未 摘 述 该 函数 ， 而 是 在 描述 系统 中 远 在 他 方 的 其 
他 函数 。 当然 ， 也 无 法 担保 在 包含 那个 默认 值 的 代 
人 码 修改 之 后 ， 这 里 的 注释 也 会 跟着 修改 。 











PEX 
* Port on which fitnesse would run. Defaults to <b>8082</b>. 


* 


* @param fitnessePort 
ty 
public void setFitnessePort(int fitnessePort) 


this.fitnessePort = fitnessePort; 


j 





4445 ”信息 过 多 


别 在 注释 中 添加 有 趣 的 历史 性 话题 或 者 无 关 的 
细节 描述 。 下 列 注释 来 自 某 个 用 来 测试 base64 编 解 
IAE CER. EX o ， 注 释 中 的 

其 他 细节 信息 对 于 读者 完全 没有 必要 








/* 

RFC 2045 - Multipurpose Internet Mail Extensions (MIME) 

Part One: Format of Internet Message Bodies 

section 6.8. Base64 Content-Transfer-Encoding 

The encoding process represents 24-bit groups of input bits as 
output 

strings of 4 encoded characters. Proceeding from left to right 
, a 

24-bit input group is formed by concatenating 3 8-bit input gr 
oups. 

These 24 bits are then treated as 4 concatenated 6-bit groups, 
each 

of which is translated into a single digit in the base64 alpha 
bet. 

When encoding a bit stream via the base64 encoding, the bit st 
ream 

must be presumed to be ordered with the most-significant-bit f 
irst. 

That is, the first bit in the stream will be the high-order bi 
t in 

the first 8-bit byte, and the eighth bit will be the low-order 
bit in 

the first 8-bit byte, and so on. 

uf 


4.4.16 不 明显 的 联系 

注释 及 其 描述 的 代码 之 间 的 联系 应 该 显 而 易 
见 。 如 果 你 不 嫌 厅 烦 要 写 注 释 ， 人 至 少 让 读者 能 看 着 
注释 和 代码 ， 并 且 理 解 注释 所 谈 何 物 。 


以 来 自 Apache 公 共 库 的 这 段 注释 为 例 : 








/* 
* start with an array that is big enough to hold all the pixel 
S 
* (plus filter bytes), and an extra 200 bytes for header info 
ty 


this.pngBytes = new byte[((this.width + 1) * this.height * 3) + 
200]; 





Wye ETA? 与 那个 +1 有 关系 吗 ? 或 与 
BAK? XR Ex SAR? 为 什么 用 200? 注释 
的 作用 是 解释 未 能 目 行 解释 的 代码 。 如 果 注 释 本 刁 


4.4.17 ”函数 头 


短 图 数 不 需 要 太 多 描述 。 为 只 做 一 件 事 的 短 函 
BUGS AF, WA BL BLE REI 





4.4.18 ” 非 公共 代码 中 的 Javadoc 


虽然 Javadoc 对 于 公共 API 非 常 有 用 ， 但 对 于 不 
打算 作 公 共用 途 的 代码 就 令 人 厌恶 了 。 为 系统 中 的 
类 和 函数 生成 Javadoc 页 并 非 总 有 用 ， 而 Javadoc 注 
释 额 外 的 形式 要 求 几 乎 等 同 于 八股 文章 。 


4.4.19 ”范例 


我 曾 为 首 个 XP Immersion 4! 课程 编写 了 代码 
消音 4-7 列 出 的 模块 。 这 个 模块 几乎 是 糟 料 的 代码 
和 坏 注 释 风 格 的 典范 。 后 来 Kent Beck Æ UT hri 
腔 热情 的 学 生 的 面 重 构 了 这 些 代码 ， 将 其 变 得 令 人 
fait. JGR, RE Agile Software 
Development, Principles, Patterns, and Practices 

(中 译 版 《敏捷 软件 开发 : 原则、 模式 与 实践 》 ) 
和 Software Development (HFFR) 杂志 的 “ 技 
艺 ” 专 栏 的 第 一 入 文章 中 引用 了 这 个 例子 。 


这 个 模块 最 迷人 的 地 方 是 ， 有 那么 一 阵 ， 我 们 
中 的 许多 人 痢 认 为 它 “ 文 档 做 得 很 好 ”*。 如 今 ， 我 们 
认为 它 是 一 小 团 乱 乒 。 看 看 你 能 发 现 多 少 个 不 同 的 
注释 问题 吧 。 




















代码 清单 4-7 GeneratePrimes.java 


/** 


This class Generates prime numbers up to a user specified 
maximum. The algorithm used is the Sieve of Eratosthenes. 
«p» 

Eratosthenes of Cyrene, b. c. 276 BC, Cyrene, Libya -- 

d. c. 194, Alexandria. The first man to calculate the 
circumference of the Earth. Also known for working on 
calendars with leap years and ran the library at Alexandria. 
«p» 

The algorithm is quite simple. Given an array of integers 
starting at 2. Cross out all multiples of 2. Find the next 
uncrossed integer, and cross out all of its multiples. 
Repeat untilyou have passed the square root of the maximum 
value. 


Qauthor Alphonse 
Qversion 13 Feb 2002 atp 


* Ro FF OR o OR OO HF OR HF KF KF 六 HF F 


rA 
import java.util.*; 
public class GeneratePrimes 
{ 
y 
* @param maxValue is the generation limit. 
#7 
public static int[] generatePrimes(int maxValue) 


{ 


if (maxValue >= 2) // the only valid case 
{ 

// declarations 

int s = maxValue + 1; // size of array 

boolean[] f = new boolean[s]; 

int i; 

// initialize array to true. 

for (i = 0; i < s; i++) 

f[i] = true; 

// get rid of known non-primes 

f[0] = f[1] = false; 

// sieve 

int j; 

for (i = 2; i < Math.sqrt(s) + 1; i++) 


if (f[i]) // if i is uncrossed, cross its multiples. 


N 


* i; j < s; j += i) 
false; // multiple is not prime 


j 


// how many primes are there? 
int count - 0; 
for (i = 0; i < s; itt) 


if (f[i]) 
count++; // bump count. 
} 


int[] primes = new int[count]; 


// move the primes into the result 
for (i = 0, j = 0; i< s; i++) 


if (f[i]) // if prime 
primes[j**] = i; 
} 


return primes; // return the primes 


else // maxValue < 2 
return new int[0]; // return null array if bad input. 





在 代码 清单 48 中 ， 你 可 以 看 到 该 模块 重 构 后 
的 版 本 。 注 意 ， 注 释 的 使 用 被 明显 地 限制 了 。 在 整 
个 模块 中 只 有 两 个 注释 。 每 个 注释 都 足 具 说 明 意 
Xo 


代码 清单 4-8 ”PrimeGenerator.java〈 重 构 后 ) 





/** 


* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 
* Given an array of integers starting at 2: 

* Find the first uncrossed integer, and cross out all its 


* multiples. Repeat until there are no more multiples 
* in the array. 
*/ 


public class PrimeGenerator 

{ 
private static boolean[] crossedOut; 
private static int[] result; 


public static int[] generatePrimes(int maxValue) 
{ 
if (maxValue < 2) 
return new int[0]; 
else 
{ 
uncrossIntegersUpTo(maxValue); 
crossOutMultiples(); 
putUncrossedIntegersIntoResult(); 
return result; 


j 
j 


private static void uncrossIntegersUpTo(int maxValue) 
i 
crossedOut = new boolean[maxValue + 1]; 
for (int i = 2; i < crossedOut.length; i++) 
crossedOut[i] = false; 


j 


private static void crossOutMultiples() 
{ 
int limit = determinelIterationLimit(); 
for (int i = 2; i <= limit; i++) 
if (notCrossed(i)) 
crossOutMultiplesOf(i); 


j 


private static int determineIterationLimit() 

i 
// Every multiple in the array has a prime factor that 
// is less than or equal to the root of the array size, 
// so we don't have to cross out multiples of numbers 
// larger than that root. 
double iterationLimit = Math.sqrt(crossedOut. length); 
return (int) iterationLimit; 


j 


private static void crossOutMultiplesOf(int i) 
{ 
for (int multiple = 2*i; 
multiple < crossedOut.length; 
multiple += i) 
crossedOut[multiple] - true; 


} 
private static boolean notCrossed(int i) 
{ 
return crossedOut[i] == false; 
} 


private static void putUncrossedIntegersIntoResult() 
{ 
result = new int[numberOfUncrossedIntegers()]; 
for (int j = 0, i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 
result[j**] = i; 


j 


private static int numberOfUncrossedIntegers() 
{ 
int count = 0; 
for (int i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 
count++; 


return count; 


j 
i 





很 容易 说 明 ， 第 一 个 注释 完全 是 多 余 的 ， 因 为 





CERJE AT i HE. Ai, 
BRU Aik Bad 主 释 偿 是 省 耳 读 省 去 读 县 体 算法 的 精 
力 ， 所 以 我 倾 回 于 留 下 





第 二 个 注释 显然 很 有 必要 。 它 解释 了 平方 根 作 
为 循环 限制 的 理由 。 我 找 不 到 能 说 明日 这 个 问题 的 
简单 变量 名 或 者 其 他 编程 结构 。 另 外 ， 对 平方 根 的 
使 用 可 能 也 有 点 武断 。 通 过 限制 平方 根 循环 ， 我 是 
DRHTE SENE? 平方 根 计 算 所 花 的 时 间 会 不 
会 比 省 下 的 时 间 还 要 多 ? 这 些 都 值得 考虑 。 使 用 平 
方 根 作为 循环 限制 ， 满 足 了 我 这 种 旧式 C 语 言 和 汇 
纲 语 言 黑 客 ， 不 过 我 可 不 敢 说 抵 得 上 其 他 人 为 理解 
它 而 人 花 的 时 间 和 精力 。 
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[KP78]: Kernighan and Plaugher, The Elements 
of Programming Style , 2d. ed., McGraw- Hill, 1978. 


[1] 原 注 : [KP78], p. 144. 
[2] Hk: 意 为 “运行 时 间 过 长 ”。 


[B] ENE: IDE 对 注释 中 拼写 检查 的 文 持 对 我 们 这 
些 看 大 量 代 码 的 人 实在 是 一 种 妙 事 。 


[4] ”译注 : Object Mentor 公 司 开办 的 极限 编程 深入 
TRAE o 








第 5 章 ”格式 








当 有 人 查看 底层 代码 实现 时 ， 我 们 希望 他 们 为 
其 整洁 、 一 致 及 所 感知 到 的 对 细 市 的 关注 而 震惊 。 
我 们 希望 他 们 高 融 扬 起 眉毛 ， 一 路 看 下 去 。 我 们 项 
望 他 们 感受 到 那些 为 之 达 作 的 专业 人 士 们 。 但 大 他 
们 看 到 的 只 是 一 堆 像 是 由 酒 醉 的 水 手写 出 的 鬼面 
符 ， 那 他 们 多 半 会 得 出 结论 ， 认 为 项 目 其 他 任何 部 
分 也 同样 对 细 市 漠不关心 。 








你 应 该 保持 民 好 的 代码 格式 。 你 应 该 选用 一 和 僚 
常理 代码 格 云 的 简单 规则 ， 然 后 贯彻 这 些 规则 。 如 
东 你 在 团队 中 工作 ， 则 团队 应 该 一 致 同意 采用 一 套 
简单 的 格式 规则 ， 上 所 有 成 员 都 要 间 从 。 使 用 能 玫 你 
应 用 这 些 格式 规则 的 目 动 化 工具 会 很 有 帮助 。 


5.1 格式 的 目的 


先 明确 一 下 ， 代 码 格 式 很 重要 。 代 码 格 式 不 可 
忽略 ， 必 须 严肃 对 每 。 代 人 码 格 式 天 平 沟 通 ， 而 沟通 
是 专业 开 友 者 的 头等 大 事 。 


或 许 你 认为 “让 代码 能 工作 ? 才 是 专业 开发 者 的 
头等 大 事 。 然 而 ， 我 希望 本 书 能 让 你 抛 邱 那 种 想 
法 。 你 今天 编写 的 功能 ， 极 有 可 能 在 下 一 版 本 中 被 
修改 ， 但 代码 的 可 读 性 却 会 对 以 后 可 能 发 生 的 修改 
行为 产生 深远 影响 。 原 始 代码 修改 之 后 很 信 ， 其 代 
码 风 格 和 可 读 性 仍 会 影响 到 可 维护 性 和 扩展 性 。 即 
便 代码 已 不 复 存 在 ， 你 的 风格 和 律 条 仍 存活 下 来 。 


那么 ， 哪 些 代码 格式 相关 方面 能 帮 我 们 最 好 地 
沟通 呢 ? 





52 EHA 


从 垂直 尺寸 开始 吧 。 源 代码 文件 该 有 多 大 ? 在 
Java 中 ， 文 件 尺 寸 与 类 尺寸 极其 相关 。 讨 论 类 时 再 
说 类 的 尺寸 。 现 在 先 考虑 文件 尺寸 。 


多 数 Java 源 代码 文件 有 多 大 ? SSE, A 
各 各 不 同 ， 长 度 殊 寞 ， 如 图 5-1 所 示 。 


10000.0 





1000.0 


100.0 


每 个 文件 中 的 代码 行 数 


10.0 Hex 








1.0 


junit fitnesse testNG tam jdepend ant tomcat 





图 5-1 以 对 数 标 太 显 示 的 文件 长 度 分 布 〈 方 块 高 度 =sigmay) 


图 5-1 中 涉及 7 个 不 同 项 目 : Junit、FitNesse、 
testNG、Time and Money、JDepend、Ant 和 
Tomcat。 贯 穿 方块 的 直线 两 端 显示 这 些 项 目 中 最 小 


和 最 大 的 文件 长 度 。 方 块 表 示 在 平均 值 以 上 或 以 下 
的 大 约 三 分 之 一 文件 〈 一 个 标准 偏差 由 ) 的 长 

上 度 。 方 块 中 则 位 置 束 是 平均 数 。 所 以 FitNesse 项 目 
的 文件 平均 尺寸 是 65 行 ， 而 上 面 三 分 之 一 在 40~ 
100 行 及 100 行 以 上 之 间 。FitNesse 中 最 大 的 文件 大 
约 400 行 ， 最 小 是 6 行 。 这 是 个 对 数 标尺 ， 所 以 较 小 
的 垂直 位 置 差 异 意 味 着 文件 绝对 尺寸 的 较 大 甜 异 。 


Junit, FitNessefllTime and Money 由 相对 较 小 
的 文件 组 成 。 没 有 一 个 超过 500 行 ， 多 数 都 小 于 200 
行 。Tomcat 和 Ant 则 有 些 文 件 达 到 数 千 行 ， 将 近 一 
半 文 件 长 于 200 行 。 


对 我 们 来 说 ， 这 意味 着 什么 ? 意味 着 有 可 能 
大 多 数 为 200 行 、 最 长 500 行 的 单个 文件 构造 出 色 的 
系统 (FitNesse 总 长 约 50000 行 ) 。 尽 管 这 并 非 不 可 
违背 的 原则 ， 也 应 该 乐于 接受 。 短 文件 通 利 比 长 文 
件 易 于 理解 。 


5.2.1 fea yes 


想 想 看 写 得 很 好 的 报纸 文章 。 你 从 上 到 下 阅 
读 。 在 顶部 ， 你 期 望 有 个 头条 ， 咎 诉 你 故事 主题 ， 
好 让 你 决定 是 否 要 读 下 去 。 第 一 段 是 整个 故事 的 大 
纲 ， 给 出 粗 线 条 概述 ， 但 隐藏 了 故事 细节 。 接 独 读 
下 去 ， 细 市 渐次 增加 ， 直 人 至 你 了 解 所 有 的 日 期 、 名 




















字 、 引 语 、 说 法 及 其 他 细节 。 


源 文件 也 要 像 报 纸 文 章 那样 。 名 称 应 当 人 简单 且 
一 目 了 然 。 名 称 本 刁 应 该 足够 告诉 我 们 是 售 在 正确 
的 模块 中 。 源 文件 最 顶部 应 该 给 出 高 层次 概念 和 算 
法 。 细 市 应 该 往 下 渐次 展开 ， 直 至 找到 源 文 件 中 最 
JRE FY ER BU ANAS o 


报纸 由 许多 篇 文章 组 成 :多数 短小 精怪 。 有 些 
稍微 长 点 儿 。 很 少 有 品 满 一 整 页 的 。 这 样 做 ， 报 纸 
才 可 用 。 假 石 一 份 报纸 只 登载 一 访 长 故事 ， 其 中 元 
斥 曼 无 组 织 的 事实 、 日 期 、 名 字 等 ， 没 人 会 去 读 











5.2.2 ”概念 间 垂 直方 向 上 的 区 陋 


几乎 所 有 的 代码 部 是 从 上 往 下 读 ， 从 左 往 右 
读 。 每 行 展现 一 个 表达 陈 或 一 个 子 句 ， 每 组 代码 行 
展示 一 条 完整 的 思路 。 这 些 思 路 用 空白 行 区 隅 开 
来 。 


以 代码 清单 5-1 为 例 。 在 封包 声明 、 导 入 声明 
和 每 个 函数 之 间 ， 都 有 空白 行 隐 开 。 这 条 极其 简单 
的 规则 极 大 地 影响 到 代码 的 视 沉 外观。 每 个 空白 行 
痢 是 一 条 线索 ， 标 识 出 新 的 独立 概念 。 往 下 读 代码 
HI. (RA Abas a Pe AT ZI 11. 

















代码 清单 5-1 BoldWidget.java 


package fitnesse.wikitext.widgets; 


import java.util.regex.*; 


public class BoldWidget extends ParentWidget { 
public static final String REGEXP = "''',42'''"; 
private static final Pattern pattern = Pattern.compile("'''(.+ 
?) VET ae 
Pattern.MULTILINE + Pattern.DOTALL 
); 


public BoldWidget(Parentwidget parent, String text) throws Exc 
eption ( 
super(parent); 
Matcher match - pattern.matcher(text); 
match.find(); 
addChildWidgets(match.group(1)); 


j 


public String render() throws Exception { 
StringBuffer html = new StringBuffer("«b»"); 
html.append(childHtml()).append("«/b»"); 
return html.toString(); 
} 
} 





如 代码 清单 5-2 所 示 ， 抽 抒 这 些 空白 行 ， 代码 
可 该 性 减弱 了 不 少 。 


代码 清单 5-2 BoldWidget.java 





package fitnesse.wikitext.widgets; 
import java.util.regex.*; 
public class BoldWidget extends ParentWidget { 
public static final String REGEXP = "''',«42'''"; 
private static final Pattern pattern = Pattern.compile("'''(.+ 


vy Ty 
Pattern.MULTILINE + Pattern.DOTALL); 
public BoldWidget(Parentwidget parent, String text) throws Exc 
eption ( 
super(parent); 
Matcher match - pattern.matcher(text); 
match.find(); 
addChildwidgets(match.group(1));) 
public String render() throws Exception { 
StringBuffer html - new StringBuffer("«b»"); 
html.append(childHtml()).append("«/b»"); 
return html.toString(); 
} 
} 








在 你 不 特意 注视 时 ， 后 果 就 更 严重 了 。 在 第 一 
个 例子 中 ， 代 码 组 会 跳 到 你 眼中 ， 而 第 三 个 例子 就 
像 一 堆 乱 兵 。 两 段 代码 的 区 别 ， 展 示 了 垂直 方 同 上 
区 隅 的 作用 。 


5.2.3 3E BHL; IR] EIE 


如 果 说 空白 行 隔 开 了 概念 ， 靠 近 的 代码 行 则 暗 
示 了 它们 之 间 的 紧密 关系 。 所 以 ， 紧 密 相 关 的 代码 
应 该 互相 靠近 。 注 意 代 码 清 单 5-3 中 的 注释 是 如 何 
制 汤 两 个 实体 变量 间 的 联系 的 。 





代码 清单 5-3 
public class ReporterConfig { 


* The class name of the reporter listener 
*/ 


private String m className; 


/** 
* The properties of the reporter listener 
*/ 
private List<Property> m_properties = new ArrayList<Property>( 


); 


public void addProperty(Property property) ( 
m properties.add(property); 
} 








代码 清单 5-4 更 易于 阅读 。 它 刚好 "一览 无 遗 ， 

至 少 对 我 来 说 是 这 样 。 我 一 眼 就 能 看 到 ， 这 是 个 有 
两 个 变量 和 一 个 方法 的 类 。 看 上 面 的 代码 时 ， 我 不 
pov m 得 相同 的 理解 


代码 清单 5-4 


public class ReporterConfig ( 
private String m className; 
private List«Property» m properties = new ArrayList<Property>( 


); 


public void addProperty(Property property) ( 
m properties.add(property); 
} 





5.2.4 HES 
你 是 否 曾 经 在 某 个 类 中 摸索 ， 从 一 个 函数 跳 到 





为 一 个 函数 ， 上 下 求索 ， 想 要 弄 消 楚 这 些 函 数 如 何 
操作 、 如 何 互相 相关 ， 最 后 却 被 损 糊 涂 了? 你 是 否 
曾经 百 吾 退 索 某 个 变量 或 函数 的 继承 链条 ? 这 让 人 
泪 形 ， 因 为 你 想 要 理解 系统 做 什么 ， 但 却 化 时 间 
和 精力 在 找到 和 记 住 那些 代码 雄 片 在 哪里 。 


关系 密切 的 概念 应 该 互相 靠近 [G10]。 最 然 ， 
这 条 规则 并 不 适用 于 分 布 在 不 同文 件 中 的 概念 。 除 
非 有 很 好 的 理由 ， 人 否则 残 不 要 把 关系 密切 的 概念 放 
到 不 同 的 文件 中 。 实 际 上 ， 这 也 是 避免 使 用 
protected 变 量 的 理由 之 一 。 


对 于 那些 关系 密切 、 放 置 于 同一 源 文 件 中 的 概 
念 ， 它 们 之 间 的 区 隔 应 该 成 为 对 相互 的 易 懂 度 有 多 
重要 的 衡量 标准 。 应 避免 迫使 该 者 在 源 文 件 和 关中 
跳 来 跳 去 。 


变量 声明 。 变 量 声明 应 尽 可 能 靠近 其 使 用 位 
置 。 因 为 函数 很 得 ， 本 地 变量 应 该 在 函数 的 顶部 出 
现 ， 就 像 Junit4.3.1 中 这 个 稍 长 的 函数 中 那样 。 



































private static void readPreferences() { 
InputStream is- null; 


try { 
is- new FilelInputStream(getPreferencesFile()); 
setPreferences(new Properties(getPreferences())); 
getPreferences().load(is); 


) catch (IOException e) ( 
try { 
if (is !- null) 
is.close(); 
) catch (IOException e1) { 








循环 中 的 控制 变量 应 该 总 是 在 循环 语句 中 声 
明 ， 如 下 列 来 目 同一 项 目的 绝妙 小 函数 所 示 。 


public int countTestCases() ( 
int count- 0; 
for (Test each 


: tests) 
count += each.countTestCases(); 
return count; 


j 








个 尔 ， 在 较 长 的 函数 中 ， 变 量 也 可 能 在 茶 个 代 
人 码 块 项 部 ， 或 在 循环 之 前 声明 。 你 可 以 在 以 下 摘 目 
TestNG 中 一 个 长 函数 的 代码 片段 中 找到 类 似 的 变 


里 o 





for (XmlTest test : m suite.getTests()) { 
TestRunner tr - m runnerFactory.newTestRunner(this, test); 


tr.addListener(m textReporter); 
m testRunners.add(tr); 


invoker - tr.getInvoker(); 


for (ITestNGMethod m : tr.getBeforeSuiteMethods()) { 
beforeSuiteMethods.put(m.getMethod(), m); 


for (ITestNGMethod m : tr.getAfterSuiteMethods()) ( 
afterSuiteMethods.put(m.getMethod(), m); 
} 
} 








实体 变量 应 该 在 类 的 顶部 声明 。 这 应 该 不 会 





增加 变量 的 垂直 距离 ， 因 为 在 设计 良好 的 类 中 ， 它 
们 如 果 不 是 被 该 类 的 所 有 方法 也 是 被 大 多 数 方法 所 
f. 


关于 实体 变量 应 该 放 在 哪里 ， 人 争论 不 断 。 在 
C++ 中 ， 通 音 会 采用 上 所谓 “剪刀 原则 ”(scissors 
rule) ， 所 有 实体 变量 都 放 在 底部 。 而 在 Java 中 ， 
惯例 是 放 在 类 的 顶部 。 没 理由 去 遵循 其 他 惯例 。 重 
点 是 在 谁 都 知道 的 地 方 声明 实体 变量 。 大 家 都 应 该 
知道 在 哪儿 能 看 到 这 些 声明 。 


例如 JUnit 4.3.1 中 的 这 个 奇怪 情形 。 我 极力 删 




















减 了 这 个 类 ， 好 说 明 问 题 。 如 果 你 看 到 代码 清单 大 
致 一 半 的 位 置 ， 会 看 到 在 那里 声明 了 两 个 实体 变 
量 。 如 采 放 在 更 好 的 位 置 ， 它 们 惑 会 更 明显 。 而 现 
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一 样 ) 。 








public class TestSuite implements Test { 
static public Test createTest(Class<? extends TestCase> theCla 
ss, 


String name) ( 


"un 


public static Constructor<? extends TestCase> 
getTestConstructor(Class«? extends TestCase» theClass) 
throws NoSuchMethodException { 

} 


public static Test warning(final String message) { 


a 


private static String exceptionToString(Throwable t) { 


y 


private String fName; 


private Vector<Test> fTests- new Vector<Test>(10); 


public TestSuite() { 
J 


public TestSuite(final Class<? extends TestCase» theClass) { 


"ul 


public TestSuite(Class<? extends TestCase» theClass, String n 
ame) { 


d 
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应 该 把 它们 放 到 一 起 ， 而 且 调用 者 应 该 尽 可 能 放 在 
被 调用 者 上 面 。 这 样 ， 程 序 就 有 个 自然 的 顺序 。 寿 
坚定 地 遵循 这 条 约定 ， 读 者 将 能 够 确信 函数 声明 总 
会 在 其 调用 后 很 快 出 现 。 以 源 目 FitNesse 的 代码 清 
单 5-5 为 例 。 注 意 顶 部 的 水 数 是 如 何 调用 其 下 的 也 
数 ， 而 这 些 被 调用 的 函数 又 是 如 何 调用 更 下 面 的 函 
数 的 。 这 样 束 能 轻易 找到 被 调用 的 函数 ， 极 大 地 增 
强 了 整个 模块 的 可 读 性 。 


代码 清单 5-5 WikiPageResponder.java 























public class WikiPageResponder implements SecureResponder { 
protected WikiPage page; 
protected PageData pageData; 
protected String pageTitle; 
protected Request request; 
protected PageCrawler crawler; 


public Response makeResponse(FitNesseContext context, Request 
request) 
throws Exception { 
String pageName - getPageNameOrDefault(request, "FrontPage") 


loadPage(pageName, context); 
if (page -- null) 

return notFoundResponse(context, request); 
else 

return makePageResponse(context); 


j 


private String getPageNameOrDefault(Request request, String de 
faultPageName) 
{ 
String pageName = request.getResource(); 
if (StringUtil.isBlank(pageName)) 
pageName = defaultPageName; 
return pageName; 


j 


protected void loadPage(String resource, FitNesseContext conte 
xt) 
throws Exception { 
WikiPagePath path = PathParser.parse(resource); 
crawler = context.root.getPageCrawler(); 
crawler.setDeadEndStrategy(new VirtualEnabledPageCrawler()); 
page = crawler.getPage(context.root, path); 
if (page != null) 
pageData = page.getData(); 
} 


private Response notFoundResponse(FitNesseContext context, Req 
uest request) 
throws Exception ( 
return new NotFoundResponder().makeResponse(context, request 


j 


); 


private SimpleResponse makePageResponse(FitNesseContext contex 
t) 
throws Exception { 
pageTitle = PathParser.render(crawler.getFullPath(page) ); 
String html = makeHtml(context); 


SimpleResponse response = new SimpleResponse(); 
response.setMaxAge(0); 
response.setContent(html); 

return response; 


本 


说 句 题 外 话 ， 以 上 代码 片段 也 是 把 常量 保持 在 
恰当 级 别 的 好 例子 [G35]。FrontPage 常 量 可 以 埋 在 
getPageNameOrDefault 函 数 中 ， 但 那样 融会 把 一 个 
众人 缘 知 的 第 量 埋藏 到 位 于 不 太 合适 的 辰 层 函 数 
中 。 更 好 的 做 法 是 把 它 放 在 易于 找到 的 位 置 ， 然 后 
再 传递 到 真实 使 用 的 位 置 。 











概念 相关 。 概 念 相 关 的 代码 应 该 放 到 一 起 。 
相关 性 越 吕 ， 彼 此 之 间 的 距离 吏 该 越 短 。 


如 上 上 所 述 ， 相 关 性 应 建立 在 直接 依赖 的 基础 





上 ， 如 函数 间 调 用 ， 或 函数 使 用 菏 个 变量 。 但 也 有 


其 他 相关 性 的 可 能 。 相 关 性 可 能 来 自 于 执行 相似 操 
作 的 一 组 函数 。 请 看 以 下 来 目 Junit 4.3.1 的 代码 厂 


E: 


public class Assert ( 
static public void assertTrue(String message, boolean conditio 
n) { 
if (!condition) 
fail(message); 


j 


static public void assertTrue(boolean condition) { 
assertTrue(null, condition); 


j 


static public void assertFalse(String message, boolean conditi 
on) { 
assertTrue(message, !condition); 


static public void assertFalse(boolean condition) { 
assertFalse(null, condition); 
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有 共同 的 命名 模式 ， 执 行 同一 基础 任务 的 不 同 变 
种 。 互 相 调用 是 第 二 位 的 。 即 便 没 有 互相 调用 ， 也 
应 该 放 在 一 起 。 


5.2.5 ”垂直 顺序 
一 般 而 言 ， 我 们 想 上 和 目 上 回 下 展示 函数 调用 依赖 























顺序 。 也 就 是 说 ， 被 调用 的 函数 应 该 放 在 执行 调用 
的 函数 下 面 (4 。 这 样 就 建立 了 一 种 自 顶 向 下 贯穿 
源 代 码 模块 的 民 好 信息 流 。 


像 报纸 文章 一般， 我 们 指望 最 重要 的 概念 先 出 
来 ， 指 望 以 包括 最 少 细 节 的 方式 表述 它们 。 我 们 指 
望 确 层 细节 最 后 出 来 。 这 样 ， 我 们 惑 能 扫 过 源 代 码 
文件 ， 目 最 前 面 的 几 个 函数 获知 要 由 ， 而 不 至 于 沉 
溺 到 细节 中 。 代 码 清单 5-5 就 是 如 此 组 织 的 。 或 
许 ， 更 好 的 例子 是 代码 清单 15-5， 及 代码 清单 3-7。 




















5.3 fi] fs sh 


一 行 代码 应 该 有 多 宽 ? 要 回答 这 个 问题 ， 来 看 
看 典型 的 程序 中 代码 行 的 宽度 。 我 们 再 一 次 检验 7 
个 不 同 项 目 。 图 5-2 展 示 了 这 7 个 项 目的 代码 行 宽度 
分 布 情况 。 其 中 展现 的 规律 性 令 人 印象 深刻 ，45 个 
字符 左右 的 宽度 分 布 尤为 如 此 。 其 实 ，20 一 60 的 每 
个 尺寸 ， 都 代表 全 部 代码 行 数 的 1%。 也 就 是 总 共 
4096! 或 许 其 余 30% 的 代码 行 短 于 10 个 字符 。 记 
住 ， 这 是 个 对 数 标尺 ， 所 以 图 中 长 于 80 个 字符 部 分 
的 线性 下 降 在 实际 情况 中 会 极其 可 观 。 程 序 员 们 显 
然 更 喜爱 短 代 码 行 。 
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代码 行 长 度 
图 5-2 Java 程序 代码 行 长 度 分 布 


这 说 明 ， 应 该 尽力 保持 代码 行 短小 。 死 守 80 个 
字符 的 上 限 有 点 僵化 ， 而 且 我 也 并 不 反对 代码 行 长 
度 达 到 100 个 字符 或 120 个 字符 。 再 多 的 话 ， 大 抵 就 
是 肆意 有 笋 为 了 。 


我 一 同 遵 循 无 家 拖 动 深 动 条 到 右边 的 原则 。 但 
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字符 缩小 到 如 此 程度 ， 屏 幕 上 其 至 能 容纳 200 个 字 
符 的 蜗 度 。 列 那么 做 。 我 个 人 的 上 限 是 120 个 字 
IF e 


5.3.4. 水 平方 向 上 的 区 隔 与 靠近 











我 们 使 用 空格 字符 将 彼此 紧密 相关 的 事物 连接 
到 一 起 ， 也 用 空格 字符 把 相关 性 较 弱 的 事物 分 隔 
开 。 请 看 以 下 函数 : 


private void measureLine(String line) ( 
lineCount++; 
int lineSize = line.length(); 
totalChars += lineSize; 
linewidthHistogram.addLine(lineSize, lineCount); 


recordwidestLine(lineSize); 


j 
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强调 目的 。 赋 值 语 名 有 两 个 确定 而 重要 的 要 素 : Zn 
边 和 右边 。 空 格 字 符 加 强 了 分 隔 效 果 。 


男 一 方面 ， 我 不 在 函数 名 和 左 圆 括号 之 间 加 空 
格 。 这 是 因为 函数 与 其 参数 密切 相关 ， 如 采 隅 开 ， 
融会 显得 互 无 关系 。 我 把 函数 调用 括号 中 的 参数 一 
一 隅 开 ， 强调 如 号 ， 表示 参数 是 互相 分 离 的 。 


空格 字符 的 另 一 种 用 法 是 强调 其 前 面 的 运算 

















TE 





public class Quadratic { 
public static double rooti(double a, double b, double c) { 
double determinant - determinant(a, b, c); 
return (-b + Math.sqrt(determinant)) / (2*a); 


public static double root2(int a, int b, int c) ( 


double determinant = determinant(a, b, c); 
return (-b - Math.sqrt(determinant)) / (2*a); 
J 


private static double determinant(double a, double b, double c 


return b*b - 4*a*c; 





看 看 这 些 等 式 读 起 来 多 舒服 。 乘 法 因子 之 间 没 














加 空格 ， 因 为 它们 上 共有 较 融 优先 级 。 加 减法 运算 项 
之 间 用 空格 隅 开 ， 因 为 加 法 和 减法 优先 级 较 低 。 


不 幸 的 是 ， 多 数 代码 格式 化 工具 都 会 漠视 运算 
符 优先 级 ， 从 头 到 尾 采 用 同样 的 空格 方式 。 在 重新 
格式 化 代码 后 ， 以 上 这 些微 妙 的 空格 用 法 就 消失 殖 
尽 了 。 


5.3.2 ”水 平 对 齐 


当 我 还 是 个 汇编 语言 程序 员 时 中 ， 使 用 水 平 
对 齐 来 强调 东 些 程序 结构 。 开 始 用 C、C++ 纺 但 ， 
最 终 转 问 Java 后 ， 我 继续 尽力 对 齐 一 组 声明 中 的 变 
量 名 ， 或 一 组 赋值 语句 中 的 右 值 。 我 的 代码 看 起 来 
大 概 古 这 样 : 


public class FitNesseExpediter implements ResponseSender 











private Socket socket; 


private InputStream input; 


private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 
private long requestParsingDeadline; 
private boolean hasError; 
public FitNesseExpediter (Socket S, 
FitNesseContext context) throws Excepti 
on 
{ 
this.context = context; 
socket = S; 
input - s.getInputStream(); 
output - s.getOutputStream(); 
requestParsingTimeLimit = 10000; 
} 





我 友 现 这 种 对 齐 方 式 没 什么 用 。 对 齐 ， 像 是 在 





台 调 不 重要 的 东西 ， 把 我 的 目光 从 真正 的 意义 上 拉 
开 。 例 如 ， 在 上 面 的 声明 列表 中 ， 你 会 从 上 到 下 阅 
读 变 量 名 ， 而 忽视 了 它们 的 类 型 。 同 样 ， 在 赋值 语 
句 代 码 清单 中 ， 你 也 会 从 上 到 下 阅读 右 值 ， 而 对 赋 
值 运算 符 视 而 不 匈 。 更 麻烦 的 是 ， 代 码 目 动 格式 化 
工具 通常 会 把 这 类 对 齐 消除 挥 。 


所 以 ， 我 最 终 放 径 了 这 种 做 法 。 如 今 ， 我 更 辟 
欢 用 不 对 齐 的 声明 和 赋值 ， 如 下 所 示 ， 因 为 它们 指 
出 了 重点 。 如 东 有 较 长 的 列表 需要 做 对 齐 处 理 ， 那 
问题 惑 是 在 列表 的 长 度 上 而 不 是 对 齐 上 。 下 例 











FitNesseExpediter 类 中 声明 列表 的 长 度 说 明 访 类 应 
VAR A) T o 


public class FitNesseExpediter implements ResponseSender 
{ 
private Socket socket; 
private InputStream input; 
private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 
private long requestParsingDeadline; 
private boolean hasError; 


public FitNesseExpediter(Socket s, FitNesseContext context) th 
rows Exception 
t 
this.context - context; 
socket = s; 
input - s.getInputStream(); 
output = s.getOutputStream(); 
requestParsingTimeLimit = 10000; 


j 
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源 文件 是 一 种 继承 结构 ， 而 不 是 一 种 大 纲 结 
构 。 其 中 的 信息 涉及 整个 文件 、 文 件 中 每 个 类 、 类 
中 的 方法 、 方 法 中 的 代码 块 ， 也 涉及 代码 块 中 的 代 
码 块 。 这 种 继承 结构 中 的 每 一 层级 都 团 出 一 个 范 
挟 ， 名 称 可 以 在 其 中 声明 ， 而 声明 和 执行 语句 也 可 
以 在 其 中 解释 。 














要 让 这 种 范围 式 继承 结构 可 见 ， 我 们 依 源 代码 
行 在 继承 结构 中 的 位 置 对 源 代 码 行 做 缩 进 处 理 。 在 
文件 顶层 的 语句 ， 例 如 大 多 数 的 类 声明 ， 根 本 不 给 
进 。 类 中 的 方法 相对 该 类 缩 进 一 个 层级 。 方 法 的 实 
现 相 对 方法 声明 绚 进 一 个 层级 。 代 码 块 的 实现 相对 
FA as US RARE SER, UER. 
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跳 过 与 当前 关注 的 情形 无 关 的 范围 ， 例 如 if 或 while 
语句 的 实现 之 类 。 他 们 的 眼光 扫 过 左边 ， 俘 找 新 的 
REH, IEE, HAMK. KAMMER, TE 
序 融会 变 得 无 法 阅读 。 


试看 以 下 在 语法 和 语义 上 等 价 的 两 个 程序 : 


























public class FitNesseServer implements SocketServer { private F 
itNesseContext 

context; public FitNesseServer(FitNesseContext context) { this. 
context = 

context; } public void serve(Socket s) { serve(s, 10000); } pub 
lic void 

serve(Socket s, long requestTimeout) ( try ( FitNesseExpediter 
sender - new 

FitNesseExpediter(s, context); 
sender.setRequestParsingTimeLimit(requestTimeout); sender.start 
0; j 

catch(Exception e) { e.printStackTrace(); ) ) } 


public class FitNesseServer implements SocketServer { 
private FitNesseContext context; 
public FitNesseServer(FitNesseContext context) { 


this.context = context; 


j 


public void serve(Socket s) ( 
serve(s, 10000); 


public void serve(Socket s, long requestTimeout) { 


try { 
FitNesseExpediter sender - new FitNesseExpediter(s, contex 
t); 
sender.setRequestParsingTimeLimit(requestTimeout); 
sender.start(); 


catch (Exception e) ( 
e.printStackTrace(); 
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几乎 能 立即 就 辨别 出 那些 变量 、 构 造 器 、 存 取 右 和 





方法 。 只 需要 几 秒 钟 加 能 了 解 这 是 一 个 套 接 字 的 简 
单 前 澳 ， 其 中 包括 了 超时 设 定 。 而 未 绚 进 的 版 本 则 
不 经 过 一 和 鲁 折 腾 就 无 法 明日 。 


违反 绚 进 规则 。 有 时 ， 会 义 不 住 想 要 在 短小 
的 让 语句 、while 循 环 或 小 函数 中 违反 缩 进 规则 。 一 
旦 这 么 做 了 ， 我 多 数 时候 还 是 会 回头 加 上 缩 进 。 这 
样 融 避 免 了 出 现 以 下 这 种 范围 层级 夫 志 到 一 行 的 情 
UL: 


public class CommentWidget extends TextWidget 
t 





public static final String REGEXP = "A#[A4\r\n]*(?:(?:\r\n) |^n| 
NE)2* 


public CommentWidget(ParentWidget parent, String text){super(p 
arent, text);} 
public String render() throws Exception {return ""; } 


j 








TES EY REA SAREE Al, EE: 


public class CommentWidget extends TextWidget { 
public static final String REGEXP = "A#[A4\r\n]*(?:(?:\r\n) |^n| 
\r)?"; 


public CommentWidget(ParentWidget parent, String text) { 
super(parent, text); 


public String render() throws Exception { 
return ""; 


j 


J 





5.3.4 空 范围 


有 时，while 或 for 语 句 的 语句 体 为 空 ， 如 下 所 
示 。 我 不 喜欢 这 种 结构 ， 尽 量 不 使 用 。 如 果 无 法 避 
免 ， 怠 确保 空 范围 体 的 缩 进 ， 用 括号 包围 起 来 。 我 
无 法 告诉 你 ， 我 曾经 多 少 次 被 静 静 安 坐 在 与 while 循 
环 语句 同一 行 末 尾 的 分 写 所 欺骗 。 除 非 你 把 那个 分 
号 放 到 另 一 行 再 加 以 缩 进 ， 否 则 束 很 难看 到 它 。 

















while (dis.read(buf, 0, readBufferSize) !- -1) 


了 





5.4 队 规 则 


每 个 程序 员 都 有 上 自己 喜欢 的 格式 规则 ， 但 如 果 
在 一 个 团队 中 工作 ， 就 是 团队 说 了 算 A, 














一 组 开 友 者 应 当 认 同一 种 格式 风格 ， 每 个 成 员 
部 应 该 采用 那 种 风格 。 我 们 想 要 让 软件 拥有 一 以 贯 
之 的 风格 。 我 们 不 想 让 它 显 得 是 由 一 大 紧 意 见 相左 
的 个 人 所 写成 。 


2002 年 启动 FitNesse 项 目 时 ， 我 和 开发 团队 一 
起 制订 了 一 套 编码 风格 。 这 只 花 了 我 们 10 分 钟 时 
间 。 我 们 决定 了 在 什么 地 方 放 置 括号 ， 缩 进 几 个 字 
符 ， 如 何 命名 类 、 变 量 和 方法 ， 如 此 等 等 。 然 后 ， 
我 们 把 这 些 规则 编写 进 IDE 的 代码 格式 功能 ， 接 着 
就 一 直 治 用 。 这 些 规则 并 非 全 是 我 喜爱 的 ;但 它们 
是 团队 决定 了 的 规则 。 作 为 团队 一 员 ， 在 为 
FitNesse 项 目 编写 代码 时 ， 我 遵循 这 些 规则 。 








记 住 ， 好 的 软件 系统 是 由 一 系列 读 起 来 不 错 的 
代码 文件 组 成 的 。 它 们 需要 拥有 一 致 和 顺畅 的 风 
格 。 读 者 要 能 确信 ， 他 们 在 一 个 源 文件 中 看 到 的 格 
式 风格 在 其 他 文件 中 也 是 同样 的 用 法 。 绝 对 不 要 用 
各 种 不 同 的 风格 来 编写 源 代码 ， 这 样 会 增加 其 复杂 


度 。 














5.5 SL ASCH FS A 

我 个 人 使 用 的 规则 相当 简单 ， 如 代码 清单 5-6 
所 示 。 可 以 把 这 段 代 码 看 作 是 展示 如 何 把 代码 写成 
最 好 的 编码 标准 文档 的 范例 。 


代码 清单 5-6 CodeAnalyzer.java 








public class CodeAnalyzer implements JavaFileAnalysis { 
private int lineCount; 
private int maxLineWidth; 
private int widestLineNumber; 
private LineWidthHistogram linewidthHistogram; 
private int totalChars; 


public CodeAnalyzer() ( 
linewidthHistogram = new LineWidthHistogram(); 


j 


public static List<File> findJavaFiles(File parentDirectory) { 
List<File> files = new ArrayList<File>(); 
findJavaFiles(parentDirectory, files); 
return files; 


j 


private static void findJavaFiles(File parentDirectory, List<F 
ile» files) { 
for (File file : parentDirectory.listFiles()) { 
if (file.getName().endsWith(".java")) 
files.add(file); 
else if (file.isDirectory()) 
findJavaFiles(file, files); 
} 
} 


public void analyzeFile(File javaFile) throws Exception { 
BufferedReader br = new BufferedReader(new FileReader(javaFi 


le)); 
String line; 
while ((line = br.readLine()) != null) 
measureLine(line); 


j 


private void measureLine(String line) { 
lineCount++; 
int lineSize = line.length(); 
totalChars += lineSize; 
linewidthHistogram.addLine(lineSize, lineCount); 
recordwidestLine(lineSize); 


j 


private void recordWidestLine(int lineSize) { 
if (lineSize > maxLineWidth) { 
maxLinewidth = lineSize; 
widestLineNumber = lineCount; 
} 
} 


public int getLineCount() { 
return lineCount; 


j 


public int getMaxLineWidth() 1 
return maxLineWidth; 


j 


public int getWidestLineNumber() ( 
return widestLineNumber; 


j 


public LinewidthHistogram getLinewidthHistogram() { 
return lineWidthHistogram; 


j 


public double getMeanLineWidth() ( 
return (double) totalChars / lineCount; 


j 


public int getMedianLineWwidth() { 
Integer[] sortedwidths - getSortedWidths(); 
int cumulativeLineCount = 0; 
for (int width : sortedWidths) ( 


cumulativeLineCount += lineCountForWidth(width); 
if (cumulativeLineCount > lineCount / 2) 
return width; 


throw new Error("Cannot get here"); 


j 


private int lineCountForWidth(int width) ( 
return lineWidthHistogram.getLinesforWidth(width).size(); 

} 

private Integer[] getSortedwidths() { 
Set<Integer> widths = lineWidthHistogram.getWidths(); 
Integer[] sortedwidths = (widths.toArray(new Integer[0])); 
Arrays.sort(sortedWidths); 
return sortedWidths; 

} 

} 





[1] È: 方块 显示 平均 数 的 sigma/2 以 上 及 以 下 
长 度 。 没 错 ， 我 知道 文件 长 度 分 布 不 太 寻 常 ， 所 以 
标准 偶 兰 也 并 非 那么 精确 。 不 过 在 此 并 不 寻求 精 


确 ， 只 是 找 个 感光 罢了 o 


[2] 。 原 注 Pascal、C 和 C++ 等 语言 中 完全 不 同 ， 
在 这 些 语言 中 ， 函 数 应 该 在 被 调用 之 前 定义 ， 至 少 
E 2 

Fe Fa HH. 


[B] EE: 开 什 么 玩笑 ! 到 现在 我 仍 是 个 汇编 语 
Ben. WEARER DD, MAA 
把 铁 拿 走 可 难 ! 














[A] “译注 : 团队 规则 ， 原 文 team rules。 单 词 rule 在 
这 里 有 两 个 意思 ， 一 个 是 名 词 “ 规 则 ”， 一 个 是 动 
词 “ 管 辖 "， 所 以 本 节 标 题 玩 了 个 文字 游戏 。 中 文 不 
易 翻 出 ， 故 采取 意译 加 注 。 


第 6 章 对象 和 数据 结构 








将 变量 设置 为 私有 (private) 有 一 个 理由 : 我 
们 不 想 其 他 人 依赖 这 些 变 量 。 我 们 还 想 在 心血 来 淹 
时 能 自由 修改 其 类 型 或 实现 。 那 么 ， 为 什么 还 是 有 


那么 多 程序 员 给 对 象 目 动 谎 加 赋值 磺 和 取 值 医 ， 将 
私有 变量 公之于众 、 如 同 它 们 根本 就 是 公共 变量 一 
般 呢 ? 





61 数据 抽象 


看 看 代码 清单 6-1 和 代码 清单 6-2 之 间 的 区 别 。 
每 段 代 码 都 表示 笛 卡 儿 平 面 上 的 一 个 点 。 不 过 ， 其 
中 之 一 曝露 了 其 实现 ， 而 妨 一 个 则 完全 隐藏 了 其 实 
现 。 





代码 清单 6-1 具象 点 


public class Point ( 
public double x; 
public double y; 


j 





代码 清单 6-2 ”抽象 点 


public interface Point ( 
double getX(); 
double getY(); 
void setCartesian(double x, double y); 
double getR(); 
double getTheta(); 


void setPolar(double r, double theta); 





代码 请 单 6-2 的 齐 亮 之 处 在 于 ， 你 不 知道 该 实 
现 会 是 在 窍 形 坐标 系 中 还 是 在 极 坐标 系 中 。 可 能 
个 都 不 是 ! 然而 ， 该 接口 还 是 明白 无 误 地 呈现 了 一 











种 数据 结构 。 


不 过 它 呈 现 的 还 不 止 是 一 个 数据 结构 。 那 些 方 
法 固定 了 一 套 存 取 策略 。 你 可 以 单独 读 取 某 个 从 
标 ， 但 必须 通过 一 次 原子 操作 设 定 所 有 坐标 。 


而 代码 清单 6-1 则 非常 清楚 地 是 在 矩形 坐标 系 
中 实现 ， 并 要 求 我 们 单个 操作 那些 坐标 。 这 就 曝 吉 
了 实现 。 实 际 上 ， 即 便 变 量 都 是 私有 ， 而 且 我 们 也 
通过 变量 取 值 器 和 赋值 器 使 用 变量 ， 其 实现 仍然 旧 
RT. 


隐藏 实现 并 非 只 是 在 变量 之 间 放 上 一 个 函数 层 
那么 简单 。 隐 藏 实现 关乎 抽象 ! 类 并 不 简单 地 用 取 
值 锋 和 赋值 右 将 其 变量 推 癌 外间 ， 而 是 工 露 抽象 接 
E 以 便 用 户 无 需 了 解数 据 的 实现 就 能 操作 数据 本 


























看 看 代码 清单 6-3 和 代码 清单 6-4。 前 者 使 用 具 
象 手段 与 机 动车 的 燃料 层 通 信 ， 而 后 者 则 采用 百 分 
比 抽象 。 你 能 确定 前 者 里 面 都 是 些 变 量 存 取 器 ， 而 
却 无 法 得 知 后 者 中 的 数据 形态 。 


代码 清单 6-3 ”有 具象 机 动车 











public interface Vehicle { 
double getFuelTankCapacityInGallons(); 
double getGallonsOfGasoline(); 


pM 
代码 清单 6-4 抽象 机 动车 


public interface Vehicle ( 
double getPercentFuelRemaining(); 


j 





以 上 两 段 代 码 以 后 者 为 佳 。 我 们 不 愿 曝露 数据 
细 市 ， 更 愿意 以 抽象 形态 表述 数据 。 这 并 不 只 是 用 
接口 和 /或 赋值 占 、 取 值 占 就 万 事 大 吉 。 要 以 最 好 的 
方式 呈现 东 个 对 象 包 合 的 数据 ， 需 要 做 严肃 的 思 
考 。 傻 乐 者 乱 加 取 值 毅 和 赋值 问 ， 是 最 坏 的 选择 。 











6.2. 数据、 对 象 的 反对 称 性 


这 两 个 例子 展示 了 对 象 与 数据 结构 之 间 的 径 
异 。 对 象 把 数据 隐藏 于 抽象 之 后 ， 曝 露 操 作 数 据 的 
函数 。 数 据 结构 曝露 其 数据 ， 
数 。 回 过 头 再 恋 一 过 。 留 意 这 两 种 定义 的 本 质 。 
们 是 对 立 的 。 这 种 差异 貌似 微小 ， (AE P T A 
pur 











例如 ， 代 码 清单 6-5 中 的 过 程式 代码 形状 范 
例 。Geometry 类 操作 三 个 形状 类 。 形 状 类 都 是 简单 
ESERE at, 没有 任何 行为 。 所 有 行为 都 在 
Geometry 类 中 。 


代码 清单 6-5 ”过 程式 形状 代码 





public class Square { 
public Point topLeft; 
public double side; 

} 


public class Rectangle { 
public Point topLeft; 
public double height; 
public double width; 

} 


public class Circle { 
public Point center; 
public double radius; 


public class Geometry { 
public final double PI - 3.141592653589793; 


public double area(Object shape) throws NoSuchShapeException 


if (shape instanceof Square) { 
Square s = (Square)shape; 
return s.side * s.side; 


else if (shape instanceof Rectangle) { 
Rectangle r = (Rectangle)shape; 
return r.height * r.width; 


else if (shape instanceof Circle) ( 
Circle c - (Circle)shape; 
return PI * c.radius * c.radius; 


j 


throw new NoSuchShapeException(); 





T Ta) YT REF Pa HI BE ROSE ZZ DAS, dE UL 





这 是 过 程式 代码 他 们 大 概 是 对 的 ， 不 过 这 种 呈 
笑 并 不 完全 正确 。 想 想 看 ， 如 果 给 Geometry 类 添加 
一 个 primeter( ) 函 数 会 怎样 。 那 些 形状 类 根本 不 会 
因此 而 受 影响 ! 另 一 方面 ， 如 果 添 加 一 个 新 形状 ， 
就 得 修改 Geometry 中 的 所 有 函数 来 处 理 它 。 再 读 一 
裔 代码 。 注 意 ， 这 两 种 情形 也 是 直接 对 江 的 。 


现在 来 看 看 代码 清单 6-6 中 的 面向 对 象 方 案 。 
这 里 ，area( ) 方 法 是 多 态 的 。 不 需要 有 Geometry 
类 。 所 以 ， 如 果 添 加 一 个 新 形状 ， 现 有 的 函数 一 
个 也 不 会 受到 影响 ， 而 当 添 加 新 函数 时 所 有 的 形状 

















都 得 做 修改 本 | 
代码 清单 6-6 ”多 态 式 形状 


public class Square implements Shape { 
private Point topLeft; 
private double side; 


public double area() { 
return side*side; 
} 
} 


public class Rectangle implements Shape { 
private Point topLeft; 
private double height; 
private double width; 


public double area() { 
return height * width; 
} 
} 


public class Circle implements Shape { 
private Point center; 
private double radius; 
public final double PI = 3.141592653589793; 


public double area() { 
return PI * radius * radius; 
} 
} 





我 们 再 次 看 到 这 两 种 定义 的 本 质 ， 它 们 是 截然 
对 并 的 。 这 说 明了 对 象 与 数据 结构 之 间 的 二 分 原 
EE 





过 程式 代码 《使 用 数据 结构 的 代码 ) 便于 在 不 
改动 既 有 数据 结构 的 前 提 下 添加 新 函数 。 面 癌 对 和 象 
代码 便于 在 不 改动 既 有 函数 的 前 提 下 添加 新 区 。 


肥 过 来 讲 也 说 得 通 : 


过 程式 代码 难以 添加 新 数据 结构 ， 因 为 必须 修 
改 所 有 图 数 。 面 问 对 象 代码 难以 添加 新 图 数 ， 因 为 
必须 修改 所 有 关 。 


所 以 ， 对 于 面 癌 对 象 较 难 的 事 ， 对 于 过 程式 代 
BARRI, ZINA! 


在 任何 一 个 复杂 系统 中 ， 都 会 有 需要 添加 新 数 
据 关 型 而 不 是 新 函数 的 时 候 。 这 时 ， 对 象 和 面 问 对 
象 承 比 较 适 合 。 必 一 方面 ， 也 会 有 想 要 谎 加 新 函数 
而 不 是 数据 类 型 的 时 候 。 在 这 种 情况 下 ， 过 程式 代 
RO RUBUS Z5 RAI SH rd 


老练 的 程序 员 知道 ， 一 切 都 是 对 象 只 是 一 个 传 
说 。 有 时 候 你 真 的 想 要 在 简单 数据 结构 上 做 一 些 过 
程式 的 操作 。 











63 ”得 墨 忒 耳 律 


著名 的 得 墨 忒 耳 律 (The Law of Demeter) ?! 
认为 ， 模 块 不 应 了 解 它 所 操作 对 象 的 内 i 部 情形 。 
如 上 节 所 见 ， 对 象 隐 羧 数据， 曝露 操作 。 这 意味 痢 
对 象 不 应 通过 存 取 需 蚂 露 其 内 部 结构 ， 因 为 这 样 更 
像 是 明 露 而 非 隐 猴 其 内 部 结构 。 


更 准确 地 说 ， 得 墨 武 耳 律 认 为 ， 类 C 的 方法 人 
应 该 调用 以 下 对 象 的 方法 ; 








e C 

。 FFE! SEY XT Be 

。 作为 参数 传递 给 { 的 对 象 

。 由 C 的 实体 变量 持 有 的 对 象 。 


方法 不 应 调用 由 任何 函数 返回 的 对 象 的 方 
法 。 换 言 之 ， 只 跟 朋友 谈话 ， 不 与 陌生 人 谈话 。 


FIRE B 违反 了 得 墨 忒 耳 律 〈 除 了 违反 其 
他 规则 之 外 ) ， 因 为 它 调用 了 getOptions( ) 返 回 值 
的 getScratchDir( ) 函 数 ， 又 调用 了 getScratchDir( ) 返 
回 值 的 getAbsolutePath( ) 方 法 。 


final String outputDir = ctxt.getOptions().getScratchDir().getA 














bsolutePath(); 


6.3.1 火车 失事 











D> 


C 
= GRGA NI w ZI Sess 
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这 类 代码 第 被 称 作 火车 失事 ， 因 为 它 看 起 来 
就 像 是 一 列 火车 。 这 关连 串 的 调用 通 帝 被 认为 是 及 
脏 的 风格 ， 应 该 避免 [G36]。 最 好 做 类 似 如 下 的 切 


js 


Options opts - ctxt.getOptions(); 
File scratchDir - opts.getScratchDir(); 
final String outputDir - scratchDir.getAbsolutePath(); 





EAM SIE XS S TERES? 当然 ， 模 


块 知 道 ctxt 对 象 包含 有 多 个 选项 ， 每 个 选项 中 都 有 
一 个 临时 目录 ， 而 每 个 临时 目录 都 有 一 个 绝对 路 
径 。 对 于 一 个 函数 ， 这 些 知 识 真 够 丰富 的 。 调 用 函 
BUTE AS OO fe E — ACH AI FRE S T8] 9] bi o 


jo ESO AE eI aE, HUC ctxt. 
Options 和 ScratchDir 是 对 象 还 是 数据 结构 。 如 果 是 
对 象 ， 则 它们 的 内 部 结构 应 当 隐 藏 而 不 曝露 ， 而 有 
关 其 内 部 细节 的 知识 瓯 明显 违 反 了 得 墨 忒 耳 律 。 如 
果 ctxt、Options 和 ScratchDir 只 是 数据 结构 ， 没 有 任 
何 行为 ， 则 它们 目 然 会 曝露 其 内 部 结构 ， 得 黑 臣 耳 
EWAN AN T -o 


属性 访问 器 函数 的 使 用 把 问题 搞 复杂 了 。 如 果 
像 下 面 这 样 写 代码 ， 我 们 大 概 就 不 会 提 及 对 得 墨 起 














耳 律 的 违反 。 


final String outputDir = ctxt.options.scratchDir.absolutePath; 








WRAEK FAA A ee, A K 
数 ， 而 对 象 则 拥有 私有 变量 和 公共 函数 ， 这 个 问题 
束 不 那么 混淆 。 然 而 ， 有 些 框 保 和 标准 甚至 要 求 最 
简单 的 数据 结构 都 要 有 访问 右 和 改 值 右 。 








6.3.2 ”混杂 


这 种 混 消 有 时 会 不 羊 导致 混合 结构 ， 一 半 和 是 对 
象 ， 一 半 是 数据 结构 。 这 种 结构 拥有 执行 操作 的 函 
数 ， 也 有 公共 变量 或 公共 访问 器 及 改 值 器 。 无 论 出 
TERE, ARW H as RUE ai BIE AL A Ae Be 
公开 化 ， 谤 导 外 部 函数 以 过 程式 程序 使 用 数据 结构 
的 方式 使 用 这 些 变量 A 。 

此 闫 混杂 增加 了 添加 新 函数 的 难度 ， 也 增加 了 
添加 新 数据 结构 的 难度 ， 两 面 不 讨好 。 应 避免 创造 
这 种 结构 。 它 们 的 出 现 ， 展 示 了 一 种 乱 七 八 粮 的 设 
计 ， 其 作者 不 确定 一 一 或 者 更 糟 迷 ， 完 全 无 视 一 一 
他 们 是 否 需 要 函数 或 类 型 的 保护 。 


6.3.3 BEIRA 
假使 ctxt、Options 和 ScratchDir 是 拥有 真实 行为 
的 对 象 又 怎样 呢 ? 由 于 对 象 应 隐藏 其 内 部 结构 ， 我 


们 融 不 该 能 够 看 到 内 部 结构 。 这 样 一 来 ， 如 何 才能 
取得 临时 目录 的 绝对 路 径 呢 ? 


ctxt.getAbsolutePathOfScratchDirectoryOption(); 


或 者 


ctx.getScratchDirectoryOption().getAbsolutePath( ) 
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第 一 种 方案 可 能 导致 ctxt 对 象 中 方法 的 曝露 。 
第 二 种 方案 是 在 假设 getScratchDirectoryOption() 返 
回 一 个 数据 结构 而 非 对 象 。 两 种 方案 感 党 都 不 好 。 


如 果 ctxt 是 个 对 象 ， 就 应 该 要 求 它 做 点 什么 ， 
不 该 要 求 它 给 出 内 部 情形 。 那 我 们 为 何 还 要 得 到 临 
时 目录 的 绝对 路 径 呢 ? 我 们 要 它 做 什么 ? 来 看 看 同 
一 模块 《许多 行 之 后 ) 的 这 段 代码 : 














String outFile = outputDir + "/" + className.replace('.', '/') 
+ ",class"; 
FileOutputStream fout - new FileOutputStream(outFile); 


BufferedOutputStream bos - new BufferedOutputStream(fout); 








JURA HIE ZRS AR ([G34][G36)) AA 
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此 随便 地 混杂 到 一 起 。 不 过 ， 撒 开 这 些 毛 病 ， 我 们 
发 现 ， 取 得 临时 目录 绝对 路 径 的 初衷 是 为 了 创建 指 
定名 称 的 临时 文件 。 


所 以 ， 直 接 让 ctxt 对 象 来 做 这 事 如 何 ? 


BufferedOutputStream bos = ctxt.createScratchFileStream(classFi 
leName); 











这 下 看 起 来 像 是 个 对 象 做 的 事 了 ! ctxt 隐 藏 了 
其 内 部 结构 ， 防 止 当前 函数 因 浏览 它 不 该 知道 的 对 
RER Fp as aN ALE 








6.4 数据 传送 对 象 


最 为 精练 的 数据 结构 ， 是 一 个 只 有 公共 变量 、 
没有 函数 的 类 。 这 种 数据 绪 构 有 时 被 称 为 数据 传送 
对 象 ， 或 DTO (Data Transfer Objects) 。DTO 是 非 
第 有 用 的 结构 ， 尤 其 是 在 与 数据 库 通 信 、 或 解析 套 
接 字 传递 的 消 轧 之 类 场景 中 。 在 应 用 程序 代码 里 一 
系列 将 原始 数据 转换 为 数据 库 的 翻译 过 程 中 ， 它 们 
往往 是 排头 兵 。 


更 遇见 的 是 如 代码 清单 6-7 所 示 的 “bean” 结 构 。 
豆 络 构 拥有 由 赋值 侨 和 取 值 磊 操 作 的 私有 变量 。 对 
豆 结构 的 半 封 装 会 让 菏 些 OO 纯化 论 者 感 沉 舒服 
些 ， 不 过 通常 没 有 其 他 好 处 。 


代码 清单 6-7 address.java 


























public class Address { 
private String street; 


private String streetExtra; 
private String city; 
private String state; 
private String zip; 


public Address(String street, String streetExtra, 
String city, String state, String zip) { 
this.street - street; 
this.streetExtra - streetExtra; 
this.city - city; 
this.state - state; 
this.zip - zip; 


j 


public String getStreet() { 
return street; 


public String getStreetExtra() { 
return streetExtra; 


public String getCity() ( 
return city; 


j 


public String getState() ( 
return state; 


j 


public String getZip() { 
return zip; 
} 
} 





Active Record 


Active Record 是 一 种 特殊 的 DTO 形 式 。 它 们 是 
拥有 公共 (或 可 豆 式 访问 的 ) 变量 的 数据 结构 ， 但 
通常 也 会 拥有 类 似 save 和 find 这 样 的 可 浏览 方法 。 
Active Record 一 般 是 对 数据 库 表 或 其 他 数据 源 的 直 
接 翻 译 。 


我 们 不 六 经 第 及 现 开 友 者 往 这 类 数据 结构 中 圳 
进 业 务 规则 方法 ， 把 这 类 数据 结构 当成 对 象 来 用 。 
这 是 不 乔 的 行为 ， 因 为 它 导致 了 数据 结构 和 对 象 的 





混杂 体 。 


MOR, RD Byte FE Active Record 当 做 数据 
结构 ， 并 创建 包含 业务 规则 、 隐 藏 内 部 数据 (可 能 
iz Active Record 的 实体 ) 的 独立 对 象 。 





65 小结 
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型 而 无 需 修 改 既 有 行为 ， 同 时 也 难以 在 既 有 对 象 中 
添加 新 行为 。 数 据 结构 曝露 数据 ， 没 有 明显 的 行 
为 。 便 于 同 既 有 数据 结构 谎 加 新 行为 ， 同 时 也 难以 
问 既 有 函数 添加 新 数据 结构 。 


在 任何 系统 中 ， 我 们 有 时 会 希望 能 够 灵活 地 添 
加 新 数据 类 型 ， 所 以 更 喜欢 在 这 部 分 使 用 对 象 。 另 
外 一 些 时 候 ， 我 们 希望 能 灵活 地 添加 新 行为 ， 这 时 
我 们 更 豆 欢 使 用 数据 类 型 和 过 程 。 优 夯 的 软件 开发 
者 个 带 成 见地 了 解 这 种 情形 ， 并 依据 手边 工作 的 性 
质 选 择 其 中 一 种 手段 。 











6.6 ”文献 


[Refactoring]: Refactoring: Improving the 
Design of Existing Code , Martin Fowler et al., 
Addison-Wesley, 1999. 





[1] JRE: AME RN AER A aA 
一 些 方法 ， 例 如 ，VISITOR 模 式 ， 或 双向 分 派 。 但 
这 些 技法 也 有 成 本 ， 而 且 通 常 返 回 一 种 过 程式 程序 
的 结构 。 


[2] Jm 
注 : http:;//en.wikipedia.org/wiki/Law. of Demeter . 


[3] JRVE: 来 自 Apache 框 架 中 某 处 。 





[4] 原 注 : 在 Refactoring: Improving the Design of 
Existing Code (中 译 版 《 重 构 改善 既 有 代码 的 设计 
(中 文 版 )》) 一 书 中 ， 有 时 把 这 种 情况 称 作 特性 


依恋 (Feature Envy) 。 


第 7 草 ” 铬 误 处 理 


Michael Feathers 





在 一 本 有 关 整 涪 代码 的 书 中 ， 居 然 有 讨论 错误 
处 理 的 章节 ， 看 起 来 有 些 突 元 。 错 误 处 理 只 不 过 是 
编程 时 必须 要 做 的 事 之 一 。 输 入 可 能 出 现 异常 ， 设 
备 可 能 失效 。 人 简 言 之 ， 可 能 会 出 错 ， 妆 错误 发 生 
时 ， 程 序 员 就 有 责任 确保 代码 照 音 工 作 。 


然而 ， 应 该 乔 清楚 错误 处 理 与 整洁 代码 的 天 
系 。 许 多 程序 完全 由 错误 处 理 所 占 据 。 上 所谓 局 扼 ， 
并 不 是 说 错误 处 理 束 是 全 部 。 我 的 意思 是 几乎 无 法 
看 明日 代码 所 做 的 事 ， 因 为 到 处 都 是 次 乱 的 错误 处 











理 代 码 。 错 误 处 理 很 重要 ， 但 如 条 它 捅 乱 了 代码 网 
Whee Ha RAN BG 。 


ERAP, RKM h Sit CS BA ie CR [ALES 
代码 一 一 雅致 地 处 理 错 误 代 码 的 一 些 技巧 和 思路 。 


7.1 使 用 开间 而 非 返 回 但 


在 很 入 以 前 ， 许 多 语言 都 不 支持 异常 。 这 些 语 
言 处 理 和 汇报 错误 的 手段 都 有 限 。 你 要 么 设置 一 个 
音 误 标 识 ， 要 么 返回 给 调用 者 检查 的 错误 码 。 代 码 
清单 7-1 中 的 代码 展 示 了 这 些 手段 。 


代码 清单 7-1 DeviceController.java 





public class DeviceController { 


public void sendShutDown() 1 
DeviceHandle handle - getHandle(DEV1); 
// Check the state of the device 
if (handle !- DeviceHandle.INVALID) { 
// Save the device status to the record field 
retrieveDeviceRecord(handle); 
// If not suspended, shut down 
if (record.getStatus() !- DEVICE SUSPENDED) { 
pauseDevice(handle); 
clearDeviceWorkQueue(handle); 
closeDevice(handle); 
) else ( 
logger.log("Device suspended. Unable to shut down"); 
} 
} else { 
logger.log("Invalid handle for: " + DEV1.toString()); 





这 类 手段 的 问题 在 于 ， 它 们 搞 乱 了 调用 者 代 


码 。 调 用 者 必须 在 调用 之 后 即刻 检查 错误 。 不 笠 的 
是 ， 这 个 步骤 很 容易 补遗 不。 所 以 ， 直 到 错误 时 ， 
最 好 抛 出 一 个 异常 。 调 用 代码 很 整洁 ， 其 远 辑 不 会 
ACER RAL TES BL. 


代码 清单 7-2 展 示 了 在 方法 中 遇 到 错误 时 抛 出 
寞 第 的 情形 。 


代码 清单 7-2 DeviceControllerjava (采用 异常 处 理 ) 








public class DeviceController { 


public void sendShutDown() 1 
try { 
tryToShutDown( ); 
) catch (DeviceShutDownError e) { 
logger.1log(e); 


} 

private void tryToShutDown() throws DeviceShutDownError { 
DeviceHandle handle = getHandle(DEV1); 
DeviceRecord record - retrieveDeviceRecord(handle); 


pauseDevice(handle); 
clearDeviceWorkQueue (handle); 
closeDevice(handle); 


} 
private DeviceHandle getHandle(DeviceID id) { 


throw new DeviceShutDownError("Invalid handle for: " + id.to 
String()); 


j 


[L M 


注意 这 段 代 码 整洁 了 很 多 。 这 不 仅 天 乎 关 观 。 
这 上 段 代 人 码 更 好 ， 因 为 之 前 纠结 的 两 个 元 系 设 备 天 闭 
算法 和 错误 处 理 现在 被 阳 离 了 。 你 可 以 伍 看 其 中 任 
TUR DAE E o 


7.2” 先 写 Try-Catch-Finally 语 人 句 


AU Mh —i. 它们 在 程序 中 定义 了 一 个 
范围 。 执 行 try-catch-finally 语 句 中 try 部 分 的 代码 
时 ， 你 是 在 表明 可 随时 取消 执行 ， 并 在 catch 语 句 中 
接续 。 


在 某 种 意义 上 ，try 代 码 块 束 像 是 事务 。catch 代 
码 块 将 程序 维持 在 一 种 持续 状态 ， 无 论 try 代 但 块 中 
发 生 了 什么 均 如 此 。 上 所以， 在 编写 可 能 抛 出 异 第 的 
代码 时 ， 最 好 先 写 出 try-catch-finally 语 句 。 这 能 帮 
你 定义 代码 的 用 户 应 该 期 等 什么， 无论 try 代 人 码 块 中 
执行 的 代码 出 什么 错 都 一 样 。 


来 看 个 例子 。 我 们 要 编写 访问 某 个 文件 并 读 出 
一 些 序列 化 对 象 的 代码 。 
先 写 一 个 单元 测试 ， 其 中 显示 当 文 件 不 存在 时 


将 得 县 E 








QTest(expected - StorageException.class) 
public void retrieveSectionShouldThrowOnInvalidFileName() { 


sectionStore.retrieveSection("invalid - file"); 


J 





该 测试 驱动 我 们 创建 以 下 占 位 代码 : 


public List<RecordedGrip> retrieveSection(String sectionName) { 
// dummy return until we have a real implementation 
return new ArrayList<RecordedGrip>(); 


J 








测试 失败 了 ， 因 为 以 上 代码 并 未 抛 出 异常 。 下 
一 步 ， 修 改 实现 代码 ， 尝 试 访 问 非法 文件 。 访 操作 


public List<RecordedGrip> retrieveSection(String sectionName) { 
try { 
FilelnputStream stream = new FileInputStream(sectionName ) 
} catch (Exception e) { 
throw new StorageException("retrieval error", e); 


j 


return new ArrayList<RecordedGrip>(); 








VR MIS, ALA ATR Fou. UE 
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， 使 之 符合 FileInputStream 构 造 器 真正 抛 出 的 寞 
fii» BN FileNotFoundException: 





public List<RecordedGrip> retrieveSection(String sectionName) { 
try { 
FileInputStream stream = new FileInputStream(sectionName) ; 
stream.close(); 
} catch (FileNotFoundException e) { 
throw new StorageException("retrieval error", e); 


j 
return new ArrayList«RecordedGrip»(); 
j 


如 此 一 来 ， 我 们 就 用 try-catch 结 构 定 义 了 一 个 
范围 ， 可 以 继续 用 测试 驱动 TDD) 方法 构建 剩余 
的 代码 逻辑 。 这 些 代码 逻辑 将 在 FileInputStream 利 
close 之 则 添加 ， 装 作 一 切 正常 的 样子 。 


壬 试 编写 强行 殷 出 寞 第 的 测试 ， 再 往 处 理 占 中 
添加 行为 ， 使 之 满足 测试 有 要求。 结 采 束 是 你 要 移 构 
造 try 代 码 块 的 事务 范围 ， 而 且 也 会 帮助 你 维护 好 该 
范 围 的 事务 特征 。 




















7.3 EAI AN AY E 


辩论 业已 结束 。 多 年 来 ，Java 程 序 员 们 一 直 在 
Fwa (checked exception) II EE. Java 
的 第 一 个 版 本 中 引入 可 探 异 常 时 ， 看 似 一 个 极 好 的 
点 子 。 每 个 方法 的 签名 都 列 出 它 可 能 传递 给 调用 者 
的 异 单 。 而 且 ， 这 些 异 弟 就 是 方法 类 型 的 一 部 分 。 
如 果 签 名 与 代码 实际 所 做 之 事 不 符 ， 代 人 码 在 字面 上 
WAGE VE 


那 时 ， 我 们 认为 可 控 异 第 是 个 绝妙 的 主意 ; 而 
且 ， 它 也 有 所 i. Am, MECA, X 
于 强 固 软件 的 生产 ， 它 并 非 必需 。C# 不 文 持 可 探 卉 
利 。 尽 管 做 过 勇敢 的 答 试 ，C++ 最 后 也 不 文 持 可 控 
异常 。Python 和 Ruby 同 样 如 此 。 不 过 ， 用 这 些 语言 
也 有 可 能 写 出 强 固 的 软件 。 我 们 得 决定 一 一 的 确 如 
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代价 是 什么 ? "pgs MT LA XR T AU 
闭合 原则 Uu 。 如 果 你 在 方法 中 抛 出 可 控 异 常 ， 而 
catch 语 句 在 三 个 层级 之 上 ， 你 就 得 在 catch 语 句 和 
抛 出 异常 处 之 间 的 每 个 方法 签名 中 声明 该 异常 。 
这 意味 着 对 软件 中 较 低层 级 的 修改 ， 都 将 波及 较 融 
层级 的 签名 。 修 改 好 的 模块 必须 重新 构建 、 发 布 ， 























即便 它们 目 身 所 关注 的 任何 东西 都 没 改动 过 。 


以 某 个 大 型 系统 的 调用 层级 为 例 。 顶 端 函 数 调 
用 它们 之 下 的 函数 ， 逐 级 回 下 。 假 设 某 个 位 于 最 展 
层级 的 冰 数 被 修改 为 抛 出 一 个 异常 。 如 果 该 异 妾 是 
PIRA, MRAR AMRA throw fj. XAR 
A BET Vad Z RA R AEA, MRE E > 
或 在 其 签名 中 添加 合适 的 throw 子 名 。 以 此 类 推 。 
最 终 得 到 的 束 是 一 个 从 软件 最 拘 端 贯穿 到 最 高 端的 
修改 链 ! 封装 被 打破 了 ， 因 为 在 抛 出 路 径 中 的 每 个 
函数 都 要 去 了 解 下 一 层级 的 异 彰 细节。 既然 异 负 由 
在 让 你 能 在 较 远 处 处 理 错 误 ， 可 控 异 各 以 这 种 方式 
破坏 封装 简直 束 是 一 种 耻辱 。 


如 果 你 在 编写 一 套 关 键 代码 库 ， 则 可 控 腊 第 有 
时 也 会 有 用 : 你 必须 捕 绪 异 党 。 但 对 于 一 般 的 应 用 
FHR, FARM AS a FUN tito 



































7.4 ”给 出 寞 第 友 生 的 环境 说明 


你 抛 出 的 每 个 异常 ， 都 应 当 提 供 足 够 的 环境 说 
明 ， 以 便 判 断 错误 的 来 源 和 人 处所。 在 Java 中 ， 你 可 
以 从 任何 异常 里 得 到 堆栈 踪迹 (stack trace) ; 然 
而 ， 堆 栈 踪 迹 却 无 法 告诉 你 该 失败 操作 的 初衷。 


应 创建 信息 充分 的 错误 消息 ， 并 和 异种 一 起 传 
递 出 去 。 在 消息 中 ， 包 括 失 败 的 操作 和 失败 类 型 。 
如 果 你 的 应 用 程序 有 日 志 系 统 ， 传 递 足 够 的 信息 给 
catch 块 ， 并 记录 下 来 。 








7.5 WHE Ee MARA 


对 错误 分 类 有 很 多 方式 。 可 以 依 其 来 源 分 类 : 
是 来 自 组 件 还 是 其 他 地 方 ?或 依 其 类 型 分 类 : 是 设 
备 错误 、 网 络 错误 还 是 编程 错误 ? 不 过 ， 当 我 们 在 
应 用 程序 中 定义 异 弟 类 时 ， 最 重要 的 考虑 应 该 是 它 
们 如 何 被 捕获 。 

来 看 一 个 不 太 好 的 异 弟 分 类 例子 。 下 面 的 try- 
catch-finally 语 句 是 对 某 个 第 三 方 代码 库 的 调用 。 它 
18 un f VAUS "I Beth eA PU F8: 


ACMEPort port = new ACMEPort(12); 














try { 
port.open(); 
) catch (DeviceResponseException e) ( 
reportPortError(e); 
logger.log("Device response exception", e); 
) catch (ATM1212UnlockedException e) { 
reportPortError(e); 


logger.log("Unlock exception", e); 
} catch (GMXError e) { 
reportPortError(e); 
logger.log("Device response exception"); 
) finally ( 


j 





语句 包含 了 一 大 扒 重 复 代 码 ， 这 并 不 出 奇 。 在 


大 多 数 异常 处 理 中 ， 不 管 真实 原因 如 何 ， 我 们 总 是 
做 相对 标准 的 处 理 。 我 们 得 记录 错误 ， 确 保 能 继续 
工作 。 


在 本 例 中 ， 既 然 知道 我 们 所 做 的 事 不 外 如 此 ， 
就 可 以 通过 打包 调用 API、 确 保 它 返回 通用 异常 类 
型 ， 从 而 简化 代码 。 





LocalPort port = new LocalPort(12); 
try { 
port.open(); 
) catch (PortDeviceFailure e) { 
reportError(e); 


logger.log(e.getMessage(), e); 
) finally ( 


J 








LocalPort 类 惑 是 个 简单 的 打包 类 ， 捕 获 并 翻译 
由 ACMEPort 类 抛 出 的 异常 : 





public class LocalPort { 
private ACMEPort innerPort; 


public LocalPort(int portNumber) ( 
innerPort = new ACMEPort(portNumber ); 


public void open() { 
try { 
innerPort.open(); 
} catch (DeviceResponseException e) { 
throw new PortDeviceFailure(e); 
) catch (ATM1212UnlockedException e) { 


throw new PortDeviceFailure(e); 
) catch (GMXError e) { 
throw new PortDeviceFailure(e); 
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有 用 。 实 际 上 ， 将 第 三 方 API 打 包 是 个 恨 好 的 实践 
手段 。 当 你 打包 一 个 第 三 方 API， 你 就 降低 了 对 它 
的 依赖 : 未 来 你 可 以 不 太 痛 兰 地 改 用 其 他 代码 库 。 
在 你 测试 自己 的 代码 时 ， 打 包 也 有 助 于 模拟 第 三 方 
调用 。 


打包 的 好 处 还 在 于 你 不 必 绑 死 在 某 个 特定 厂商 
的 API 设 计 上 。 你 可 以 定义 目 己 感 党 舒服 的 API。 在 
上 例 中 ， 我 们 为 port 设 备 错误 定义 了 一 个 异常 类 
型 ， 然 后 发 现 这 样 能 写 出 更 整洁 的 代码 。 


对 于 代码 的 祭 个 特定 区 域 ， 单 一 异 第 类 通 第 可 
行 。 伴 随 寞 常 发 送出 来 的 信息 能 够 区 分 不 同 错误 。 
BOR RA BRR TE» FFA BONS, a 
fi FH AN TF] I ot HY SR 
































7.6 ”定义 第 规 流 程 


如 果 你 这 循 前 文 捉 及 的 建议 ， 在 业务 逻辑 和 错 
误 处 理 代 码 之 间 惑 会 有 民 好 的 区 隔 。 大 量 代 码 会 开 
始 变 得 像 是 整 涪 而 简朴 的 算法 。 然 而 ， 这 样 做 却 把 
错误 检测 推 到 了 程序 的 边缘 地 币 。 你 打包 了 外 部 
API 以 抛 出 目 己 的 异 第 ， 你 在 代码 的 项 曾 定 义 了 一 
个 处 理 器 来 应 付 任何 失败 了 的 运算 。 在 大 多 数 时 
候 ， 这 种 手段 很 棒 ， 不 过 有 时 你 也 许 不 愿 这 么 做 。 











来 看 一 个 例子 。 下 面 的 案 代 码 来 目 茶 个 记 账 应 
用 的 开 文 总 计 模 块 : 


try { 
MealExpenses expenses = expenseReportDAO.getMeals(employee.get 
ID()); 


m total += expenses.getTotal(); 
) catch(MealExpensesNotFound e) { 


j 


m total += getMealPerDiem(); 





WA wae, WRI SAR, MFA SA 
中 。 如 宋 没 有 消耗 ， 则 员工 得 到 当日 餐 食 补贴 。 腊 





种 打 断 了 业务 锡 辑 。 如 采 不 去 处 理 特 殊 情 况 会 不 会 
E ABE A GE TNS BR ae SB fn n. MAX 











MealExpenses expenses = expenseReportDAO.getMeals(employee.getI 


D()); 


m total += expenses.getTotal(); 





能 把 代码 写 得 那样 简洁 吗 ? 能 。 可 以 修改 
ExpenseReportDAO， 使 其 总 是 返回 MealExpense 对 
象 。 如 果 没 有 和 餐 食 消耗 ， 就 返回 一 个 返回 餐 食补 贴 
的 MealExpense 对 象 。 
public class PerDiemMealExpenses implements MealExpenses { 


public int getTotal() { 
// return the per diem default 





这 种 手法 叫做 特例 模式 (SPECIAL CASE 
PATTERN, [Fowler 。 创 建 一 个 类 或 配置 一 个 对 
象 ， 用 来 处 理 特例 。 你 来 处 理 特例 ， 客 户 代 码 就 不 
puce 异常 行为 被 封装 到 特例 对 象 


7.7” 列 返 回 null 住 


RUA, BW ee AEE, whe ER AES 
FDI RERA. tek null. d 
不 想 去 计算 曾经 见 过 多 少 几乎 每 行 代码 都 在 检查 
null 值 的 应 用 程序 。 下 面 就 是 个 例子 : 





public void registerItem(Item item) { 
if (item != null) { 
ItemRegistry registry = peristentStore.getItemRegistry(); 
if (registry !- null) ( 
Item existing = registry.getItem(item.getID()); 
if (existing.getBillingPeriod().hasRetailOwner()) { 


existing.register(item); 





ISIS EIA, ESCM YO! 返回 null 
值 ， 基 本 上 是 在 给 上 自己 增加 工作 量 ， 也 是 在 给 调用 
者 添乱 。 只 要 有 一 处 没 检查 null 值 ， 应 用 程序 束 会 
失控 。 


你 有 没有 注意 到 ， 骸 僚 直 语句 的 第 二 行 没 有 检 
查 null 值 ? 如 果 在 运行 时 persistentStore T 
什么 事 ? 我 们 会 在 运行 时 得 到 一 个 
NullPointerException #8, YTA AERA Dm T 














Xr, (Uu WES. MPE OAMMR A 
。 对 于 从 应 用 程序 深 处 抛 出 的 NullPointerException 
异种 ， 你 到 底 该 作 何 反应 呢 ? 


可 以 敷衍 次 上 列 代码 的 问题 是 少 做 了 一 次 null 
值 检查 ， 其 实 问题 多 多 。 如 果 你 打算 在 方法 中 返 
9inull 值 ， 不 如 抛 出 腊 第 ， 或 是 返回 特例 对 象 。 如 
果 你 在 调用 某 个 第 三 方 API 中 可 能 返回 null 值 的 方 
法 ， 可 以 考虑 用 新 方法 打包 这 个 方法 ， 在 新 方法 中 
抛 出 异常 或 返回 特例 对 象 。 


在 许多 情况 下 ， 特 例 对 象 都 是 爽口 良药 。 设 想 




















List<Employee> employees = getEmployees(); 
if (employees != null) { 
for(Employee e : employees) { 
totalPay += e.getPay(); 


j 
} 





现在 ，getExployees 可 能 返回 null， 但 是 否 一 定 
要 这 么 做 呢 ? 如 果 修 改 getEmployee， 返 回 空 列表 ， 
束 能 使 代码 整 洁 起 来 : 





List<Employee> employees = getEmployees(); 
for(Employee e : employees) { 

totalPay += e.getPay(); 
} 


BEN 


Pr3£Java Collections.emptyList( 77; 7E, 147; 
法 返回 一 个 预定 义 不 可 变 列表 ， 可 用 于 这 种 目的 : 


public List<Employee> getEmployees() { 
if( .. there are no employees .. ) 
return Collections.emptyList(); 


J 





这 样 编码 ， 束 能 尽量 避免 NullPointerException 
的 出 现 ， 代 码 也 就 更 整洁 了 。 





7.8 HIR EnA 


FETT IRP R Enl ee FRY GS, Binu 
(Eina ABI AM EAE Y 。 除 非 API 要 求 你 癌 它 
传递 null 值 ， 售 则 惑 要 尽 可 能 避免 传递 null 值 。 


举例 说 明 原 因 。 用 下 面 这 个 简单 的 方法 计算 两 
FS ERN s 





public class MetricsCalculator 


public double xProjection(Point pi, Point p2) { 
return (p2.x - pi.x) * 1.5; 





如 果 有 人 传 入 null 值 会 怎样 ? 


calculator.xProjection(null, new Point(12, 13)); 


当然 ， 我 们 会 得 到 一 个 NullPointerException 异 
Au 
I o 


如 何 修正 ? PY PAB gE — Toro SOEUR: 


public class MetricsCalculator 
{ 
public double xProjection(Point pi, Point p2) { 
if (p1 == null || p2 == null) { 
throw InvalidArgumentException( 
"Invalid argument for MetricsCalculator.xProjection"); 


} 
return (p2.x - pi.x) * 1.5; 





这 样 做 好 些 吗 ? 可 能 比 null 指 针 异 常 好 一 些 
但 Hf. RA 12648 InvalidArgumentException = 
常 定义 处 理 器 。 这 个 处 理 器 该 做 什么 ? 还 有 更 好 的 
做 法 吗 ? 


还 有 和 丛 代 方案 。 可 以 使 用 一 组 断言 : 


public class MetricsCalculator 


public double xProjection(Point pi, Point p2) { 
assert p1 !- null : "p1 should not be null"; 
assert p2 !- null : "p2 should not be null"; 


return (p2.x - p1.x) * 1.5; 
} 
} 








看 上 去 很 美 ， 但 仍 未 解决 问题 。 如 果 有 人 传 入 
null 值 ， 还 是 会 得 到 运行 时 错误 。 


在 大 多 数 编程 语言 中 ， 没 有 民 好 的 方法 能 对 付 





由 调用 者 意外 传 入 的 null 值 。 事 已 如 此 ， 人 恰当 的 做 
法 就 是 禁止 传 入 null 值 。 这 样 ， 你 在 编码 的 时 候 ， 
就 会 时 时 记 住 参 数列 表 中 的 null 值 意味 看 出 问题 

了 ， 从 而 大 量 避 免 这 种 无 心 之 失 。 


7.9 小结 


整洁 代码 是 可 读 的 ， 但 也 要 强 回 。 可 读 与 强 回 
并 不 冲突 。 如 果 将 错误 处 理 隔 离 看 待 ， 独 立 于 主要 
逻辑 之 外 ， 束 能 写 出 强 固 而 整洁 的 代码 。 做 到 这 一 
步 ， 我 们 束 能 单独 处 理 它 ， 也 极 大 地 提升 了 代码 的 
可 维护 性 。 
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我 们 很 少 控 制 系统 中 的 全 部 软件 。 有 时 我 们 购 
买 第 三 方程 序 包 或 使 用 开放 源 代 码 ， 有 时 我 们 依靠 
公司 中 其 他 团队 打造 组 件 或 子 系统 。 不 管 是 哪 种 情 
况 ， 我 们 都 得 将 外 来 代码 干净 利落 地 整合 进 目 己 的 
代码 中 。 本 章 将 介绍 一 些 保持 软件 边界 整洁 的 实践 
手段 和 技巧 。 








8.1 使 用 第 三 方 代码 


在 接口 提供 者 和 使 用 者 之 间 ， 存 在 与 生 俱 来 的 
张力 。 第 三 方程 序 包 和 框架 提供 者 退 求 普 适 性 ， 这 
样 束 能 在 多 个 环境 中 工作 ， 吸 引 广泛 的 用 户 。 而 使 
用 者 则 想 要 集中 满足 特定 需求 的 接口 。 这 种 张力 会 
导致 系统 边界 上 出 现 问题 。 


以 java.util.Map 为 例 。 如 你 在 表 8-1 中 所 见 ， 

Map 有 痢 广 阔 的 接口 和 丰 军 的 功能 。 当 然 ， 这 种 力 
量 和 灵活 性 很 有 用 ， 但 也 要 付出 代价 。 比 如 ， 应 用 
程序 可 能 构造 一 个 Map 对 象 并 传递 它 。 我 们 的 初 囊 
可 能 是 Map 对 象 的 所 有 接收 者 都 不 要 删除 映射 图 中 
的 任何 东西 。 但 表 8-1 的 顶端 却 正好 有 一 个 dlear( ) 方 
法 。Map 的 任何 使 用 者 都 能 清除 映射 图 。 或 许 设计 
惯例 是 Map 中 只 能 保存 特定 的 类 型 ， 但 Map 并 不 会 
可 靠 地 约束 存 于 其 中 的 对 象 的 类 型 。 使 用 者 可 随意 
往 Map 中 塞 入 任何 类 型 的 条 目 。 























clear() void - Map 

containsKey(Object key) boolean - Map 
containsValue(Object value) boolean - Map 
entrySet() Set - Map 

equals(Object o) boolean - Map 

get(Object key) Object - Map 

getClass() Class«? extends Object» - Object 
hashCode() int - Map 

isEmpty() boolean - Map 

keySet() Set - Map 

notify() void - Object 

notifyAll() void - Object 

put(Object key, Object value) Object - Map 
putAll(Map t) void - Map 

remove (Object key) Object - Map 

size() int - Map 

toString() String - Object 

values() Collection - Map 

wait() void - Object 


wait(long timeout) void - Object 
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wait(long timeout, int nanos) void - Object 


图 8-1 Mop 类 的 方法 


如 果 你 的 应 用 cda 要 一 个 包容 Sensor 关 对 象 
的 Map 映 射 图 ， 大 概 会 是 这 样 : 





Map sensors = new HashMap(); 
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有 这 行 代码 : 


Sensor s = (Sensor)sensors.get(sensorId ); 


这 行 代码 一 再 出 现 。 代 码 的 调用 中 承担 了 从 
Map 中 取得 对 象 并 将 其 转换 为 正确 关 型 的 职责 。 行 
倒是 行 ， 却 并 非 整 洁 的 代码 。 而 且 ， 这 行 代码 并 未 
说 明 目 己 的 用 途 。 通 过 对 泛 型 的 使 用 ， 这 段 代 码 可 
谈 性 可 以 大 大 提高 ， 如 下 所 不: 


Map<Sensor> sensors = new HashMap<Sensor>(); 
Sensor s = sensors.get(sensorId ); 


不 过 ，Map<Sensor> 提 供 了 超出 所 需 / 所 愿 的 功 
能 的 问题 ， 仍 未 得 到 解决 。 


在 系统 中 不 受 限制 地 传递 Map<Sensor> 的 实 
体 ， 意 味 着 当 到 Map 的 接口 被 修改 时 ， 有 许多 地 方 
都 要 跟着 改 。 你 或 许 会 认为 这 样 的 改动 不 太 可 能 友 
生 ， 不 过 ， 当 Java 5 加 入 对 泛 型 的 支持 时 ， 的 确 发 
生 了 改动 。 我 们 也 的 确 见 到 一 些 系统 因为 要 做 大 量 
改动 才能 上 自由 使 用 Map 类 ， 而 无 法 使 用 泛 型 。 


使 用 Map 的 更 整 河 的 方式 大 致 如 下 。Sensors 的 











HIP AND ES SZH, AGRE GB) K 
现 细 市 才 关 心 的 。 


public class Sensors { 
private Map sensors = new HashMap(); 


public Sensor getById(String id) ( 
return (Sensor) sensors.get(id); 


J 
// HE 





边界 上 的 接口 (Map) 是 隐藏 的 。 它 能 随 来 上 自 
应 用 程序 其 他 部 分 的 极 小 的 影响 而 变动 。 对 泛 型 的 
使 用 不 再 是 个 大 问题 ， 因 为 转换 和 类 型 管理 是 在 
Sensors 类 内 部 处 理 的 。 


该 接口 也 经 过 仔细 修整 和 归 置 以 适应 应 用 程序 
的 需要 。 结 果 束 是 得 到 易于 理解 、 难 以 被 误 用 的 代 
人 码 。Sensors 类 推动 了 设计 和 业务 的 规则 。 


我 们 并 不 建议 总 是 以 这 种 方式 封装 Map 的 使 
用 。 我 们 建议 不 要 将 Map (或 在 边界 上 的 其 他 接 
口 ) 在 系统 中 传递 。 如 果 你 使 用 类 似 Map 这 样 的 边 
界 接 口 ， 束 把 它 保留 在 类 或 近 杀 类 中 。 避 人 免 从 公共 
API 中 返回 边界 接口 ， 或 将 边界 接口 作为 参数 传递 


给 公共 API。 

















8.2 浏览 和 学 习 边 界 


第 三 方 代码 帮助 我 们 在 更 少时 间 内 友 布 更 丰富 
的 功能 。 在 利用 第 三 方程 序 包 时 ， 该 从 何 处 入 手 
Ne? 我 们 没有 测试 第 三 方 代码 的 职 贡 ， 但 为 要 使 用 
的 第 三 方 代 公 编写 测试 ， 可 能 最 符合 我 们 的 利 荔 。 


设想 第 三 方 代码 库 的 使 用 方法 并 不 清楚 。 我 们 
可 能 会 化 上 一 两 天 《或 者 更 多 ) WERE, 
定 如 何 使 用 。 然 后 ， 我 们 会 编写 使 用 第 三 方 代码 的 
代码 ， 看 看 是 否 如 我 们 所 愿 地 工作 。 陷 入 长 时 间 的 
调试 、 找 出 在 我 们 或 他 们 代码 中 的 缺陷 ， 这 可 不 是 
什么 稀罕 事 。 


学 习 第 三 方 代码 很 难 。 整 合 第 三 方 代码 也 很 
难 。 同 时 做 这 两 件 事 难 上 加 难 。 如 果 我 们 采用 不 同 
的 做 法 呢 ? 不 要 在 生产 代码 中 试验 新 东西 ， 而 是 编 
写 测 试 来 届 览 和 理解 第 三 方 代 码 。Jim Newkirk 把 这 
叫做 学 习性 测试 earning tests) H . 


在 学 习性 测试 中 ， 我 们 如 在 应 用 中 那样 调用 第 
三 方 代码 。 我 们 基本 上 有 是 在 通过 核对 试验 来 检 训 目 
己 对 那个 API 的 理解 程度 。 测 试 聚焦 于 我 们 想 从 API 
得 到 的 东西 。 




















8.3 学习 log4j 


比如 ， 我 们 想 使 用 apache log4j 包 来 代 蔡 目 定 义 
的 日 志 人 代码。 我 们 下 载 了 log4j， 打 开 介 
EMANA., Mi E 一 个 测试 用 例 ， 它 能 
问 控 制 台 输出 hello 字 样 。 








QTest 
public void testLogCreate() { 
Logger logger - Logger.getLogger("MyLogger"); 


logger.info("hello"); 
j 





运行 ，logger 发 生 了 一 个 错误 ， 告 诉 我 们 需要 
用 Appender。 再 多 读 一 点 文档 ， 我 们 发 现 有 个 
ConsoleAppender。 于 是 我 们 创建 了 一 个 
ConsoleAppender， 再 看 是 否 能 解 开 "mer 台 输 出 日 
志 的 秘诀 。 


QTest 

public void testLogAddAppender() { 
Logger logger = Logger.getLogger("MyLogger"); 
ConsoleAppender appender - new ConsoleAppender(); 
logger.addAppender(appender); 








logger.info("hello"); 
j 





这 回 ， 我 们 发 现 Appender 没 有 输出 流 。 奇 怪 ， 
它 该 有 输出 流 的 。 在 Google 上 得 到 一 点 帮助 后 ， 我 
们 写 了 以 下 代码 : 


QTest 
public void testLogAddAppender() { 
Logger logger = Logger.getLogger("MyLogger"); 
logger.removeAllAppenders(); 
logger.addAppender(new ConsoleAppender( 
new PatternLayout("%p %t %m%n"'), 


ConsoleAppender.SYSTEM OUT)); 
logger.info("hello"); 








这 回 行 了 ; hello 字样 的 日 志 信 息 出 现在 控制 台 
E! 必须 Henne cto iit LE eel aS 
F, AFERKA ATIE. 


很 有 趣 ， 当 我 们 移 除 
ConsoleAppender.SystemOut 参 数 时 ， 那 个 hello 字 样 
仍然 输出 到 屏幕 上 。 但 al a D) 
会 出 现 关 于 没有 输出 流 的 错误 信息 。 这 实在 太古 怪 
Je 


再 仔细 看 看 文档 ， 我 们 看 到 默认 的 
ConsoleAppender 构 造 器 是 “未 配置 "的 ， 这 看 起 来 并 
不 明显 或 没什么 用 ， 反 而 像 是 log4j 的 一 个 缺陷 ， 或 
者 至 少 是 前 后 不 太一 致 。 























再 搜索 、 阅 读 、 测 试 ， 最 终 我 们 得 到 代码 清单 
8-1。 我 们 极 大 地 发 据 了 log4j 的 工作 方式 ， 也 将 得 
到 的 知识 融入 了 一 系列 简单 的 单元 测试 中 。 


代码 清单 8-1 LogTest.java 


public class LogTest { 
private Logger logger; 


QBefore 

public void initialize() { 
logger - Logger.getLogger("logger"); 
logger.removeAllAppenders(); 
Logger.getRootLogger().removeAllAppenders(); 

} 

QTest 

public void basicLogger() { 
BasicConfigurator.configure(); 
logger.info("basicLogger"); 


QTest 


public void addAppenderWithStream() 1 
logger.addAppender(new ConsoleAppender( 
new PatternLayout("%p %t %m%n"), 
ConsoleAppender.SYSTEM OUT)); 
logger.info("addAppenderWithStream"); 


QTest 
public void addAppenderWithoutStream() { 
logger.addAppender(new ConsoleAppender( 
new PatternLayout("%p %t %m%n"))); 
logger .info("addAppenderwWithoutStream" ); 
} 
} 








现在 我 们 知道 如 何 初 始 化 一 个 简单 的 控制 合 日 








GA WAJER CHEKAR, W 
将 应 用 程序 的 其 他 部 分 与 jog4j 的 边界 接口 隅 离开 
来 。 








8.4 学 习性 测试 的 好 处 不 只 是 免费 


学 习性 测试 坚 无 成 本 。 无 论 如 何 我 们 都 得 学 习 
要 使 用 的 API， 而 编写 测试 则 是 获得 这 些 知识 的 容 
易 而 不 会 影响 其 他 工作 的 途径 。 学 习性 测试 是 一 种 
精确 试验 ， 帮 助 我 们 增进 对 API 的 理解 。 


学 习性 测试 不 光 免 费 ， 还 在 投资 上 有 正面 的 回 
报 。 当 第 三 方程 序 包 发 布 了 新 版 本 ， 我 们 可 以 运行 
学 习性 测试 ， 看 看 程序 包 的 行为 有 没有 改变 。 


学 习性 测试 确保 第 三 方程 序 包 按照 我 们 想 要 的 
方式 工作 。 一 旦 整合 进来 ， 就 不 能 你 证 第 三 方 代码 
忆 与 我 们 的 需要 莱 容 。 原 作者 不 得 不 修改 代码 来 满 
足 他 们 目 己 的 新 需要 。 他 们 会 修正 缺陷 、 添 加 新 功 
能 。 风 险 伴随 新 版 本 而 来 。 如 果 第 三 方程 序 包 的 修 
p Wm. BATHS ERM 


无 论 你 是 否 需 要 通过 学 习性 测试 来 学 习 ， 忆 要 
有 一 系列 与 生产 代码 中 调用 方式 一 致 的 输出 测试 来 
文 持 整 洁 的 边界 。 不 使 用 这 些 边 界 测 试 来 减轻 迁移 
的 劳力 ， 我 们 可 能 会 超出 应 有 时 限 ， 长 久 地 绑 在 旧 
hÆ E H -o 























8.5 ”使 用 疝 不 存在 的 代码 


还 有 男 一 种 边界 ， 那 种 将 已 知 和 未 知 分 隔 开 的 
边界 。 在 代码 中 总 有 许多 地 方 是 我 们 的 知识 未 及 之 
处 。 有 了 时， 边界 那 边 束 是 未 知 的 (至少 目前 未 
知 ) 。 有 时 ， 我 们 并 不 往 边界 那 边 看 过 去 。 


好 多 年 以 前 ， 我 兽 在 一 个 开发 无 线 通 信 系 统 软 
件 的 团队 中 工作 。 座 系统 有 个 子 系统 
Transmitter 〈 发 送 机 ) 。 我 们 对 Transmitter 知 之 其 
少 ， 而 该 子 系统 的 开发 者 还 没有 对 接口 进行 定义 。 
我 们 不 想 受 这 种 事 阻 碍 ， 束 从 距 末 知 那 部 分 代码 很 
远 处 开始 工作 。 


对 于 我 们 的 世界 如 何 结束 、 新 世界 如 何 开始 ， 
我 们 有 许多 好 主意 。 工 作 时 ， 我 们 偶尔 会 路 越 那 道 
WH. RAB UES SEAT A LF AGI Ae 
我 们 还 是 从 工作 中 了 解 到 我 们 想 要 的 边界 接口 是 
什么 样 的。 我 们 想 要 告知 发 送 机 一 些 事 : 


将 发 送 机 置 于 指定 频率 ， 并 友 出 目 这 个 法 得 到 
的 数据 的 模拟 表示 。 


我 们 不 知 这 会 如 何 做 到 ， 因 为 API 还 没 设计 出 
来 。 所 以 ， 我 们 决定 过 后 再 编写 细 市 代码 。 









































为 了 不 受阻 碍 ， 我 们 定义 了 目 己 使 用 的 接口 。 
我 们 给 它 取 了 个 好 记 的 名 字 ， 比 如 Transmitter。 我 
们 给 它 写 了 个 名 为 transmit 的 方法 ， 获 取 频 率 参 数 和 
数据 流 。 这 束 是 我 们 希望 得 到 的 接口 。 


编写 我 们 想得到 的 接口 ， 好 处 之 一 是 它 在 我 们 
控制 之 下 。 这 有 助 于 保持 客户 代码 更 可 读 ， 且 集中 
于 它 该 完成 的 工作 。 


在 图 8-2 中 可 以 看 到 ， 我 们 将 
CommunicationsController2$ M Rik 28 API 〈 访 API 不 
受 我 们 控制 ， 而 且 还 没 定 义 ) 中 隔离 出 来 。 通 过 使 
用 符合 应 用 程序 的 接口 ，CommunicationsController 
代码 整洁 且 足 以 表达 其 意图 。 一 旦 发 送 吉 API 被 定 
X Ho, FRAT 5) TransmitterAdapter2K 25 £22 .- 
ADAPTER |?! 封装 了 与 API 的 互动 ， 也 提供 了 一 个 
当 API 发 生变 动 时 唯一 需要 改动 的 地 方 。 















<<interface>> 
Transmitter 


+transmit (frequency, stream) 
[\ 


VE Bee ies Transmitter <<future>> 
图 8-2 MAIS AY ToU 


这 套 设 计 方 案 为 测试 提供 了 一 种 极为 方便 的 接 
颖 6 。 使 用 适当 的 FakeTransmitter， 我 们 就 能 测试 
CommunicationsController 类 。 在 拿 到 TransmitterAPI 


时 ， 我 们 也 能 创建 确保 正确 使 用 API 的 边界 测试 。 


通信 控制 器 


8.6 ”整洁 的 边界 


边界 上 会 发 生 有 趣 的 事 。 改 动 是 其 中 之 一 。 有 
民 好 的 软件 设计 ， 无 需 巨 大 投入 和 重 写 即 可 进行 修 
改 。 在 使 用 我 们 控制 不 了 的 代码 时 ， 必 须 加 倍 小 心 
保护 投资 ， 确 保 未 来 的 修改 不 至 于 代价 太 大 。 


边界 上 的 代码 需要 清晰 的 分 割 和 定义 了 期 望 的 
测试 。 应 该 避免 我 们 的 代码 过 多 地 了 解 第 三 方 代 三 
中 的 特定 信息 。 依 靠 你 能 控制 的 东西 ， 好 过 依靠 你 
控制 不 了 的 东西 ， 免 得 日 后 受 它 控制 。 


我 们 通过 代码 中 少数 几 处 引用 第 三 方 边界 接口 
的 位 置 来 管理 第 三 方 边界 。 可 以 像 我们 对 待 Map 那 
样 包 装 它们 ， 也 可 以 使 用 ADAPTER 模 式 将 我 们 的 
接口 转换 为 第 三 方 提供 的 接口 。 采 用 这 两 种 方式 ， 
代码 都 能 更 好 地 与 我 们 沟通 ， 在 边界 两 边 推动 内 部 
一 致 的 用 法 ， 当 第 三 方 代 码 有 改动 时 修改 点 也 会 更 
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Om ”单元 训 试 
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过 去 十 年 以 来 ， 编 程 专业 领域 进步 很 大 。1997 
年 时 ， 没 人 昕 说 过 测试 驱动 开 友 。 对 于 我 们 之 中 的 
大 多 数 人 来 说 ， 单 元 测试 是 那 种 用 来 确保 程序 “可 
运行 ”的 用 过 即 扔 的 短 代码 。 我 们 辛勤 地 编写 类 和 
方法 ， 再 弄 出 一 些 特殊 代码 来 测试 它们 。 通 常 这 会 
是 种 简单 的 驱动 式 程序 ， 让 我 们 能 够 手工 与 目 己 编 
写 的 程序 交互 。 


我 记得 在 20 世 纪 90 年 代 曾 为 一 套 柑 入 式 实时 系 





统 编写 过 C++ 程序 。 该 程序 是 个 简单 的 计时 器 ， 有 
如 下 签名 : 


void Timer::ScheduleCommand(Command* theCommand, int millisecon 
ds) 


AAR fa; BATE MANY, YE— rz 
程 中 执行 Command 的 excute 方 法 。 问 题 在 于 如 何 测 
WE o 


我 随便 写 了 个 简单 的 驱动 式 程序 ， 聆 听 来 自 键 
盘 的 动作 。 键 盘 输 入 一 个 字符 时 ， 它 束 安 排 5 秒 钟 
之 后 输出 同样 的 字符 。 我 输入 了 一 句 融 节 委 的 歌 
词 ， 然 后 等 痢 5 秒 钟 之 后 它 在 屏幕 上 重 现 出 来 。 











I... want-a-girl . . . just . . like-the-girl-who- 
marr .. .ied...dear...old...dad.U 


FETE FABLES ERY, RERE A AD BEE 
当 那 些 句 点 出 现在 屏幕 上 时 ， 我 又 再 哼 了 一 次 。 

那 融 是 我 的 测试 ! 我 看 到 这 法 子 可 行 ， 演 示 给 
ASHI, Mami Made T o 


如 前 文 所 述 ， 我 们 的 专业 领域 进步 其 多 。 如 
今 ， 我 会 编写 测试 ， 确 保 代码 中 每 个 特 角 侣 兄 痢 如 











我 所 愿 地 工作 。 我 会 将 代码 和 操作 系统 隅 离开 ， 而 
不 是 直接 调用 标准 计时 功能 。 我 会 伪造 一 父 计 时 画 
数 ， 这 样 就 能 全 面 控制 时 间 。 我 会 安排 一 些 设置 布 
尔 值 标识 的 命令 ， 往 前 步 进 时 间 ， 玛 看 这 些 标识 ， 
确保 它们 在 我 将 时 间 调 到 正确 值 时 由 false 变 为 


true。 





有 了 一 套 运行 通过 的 测试 ， 我 会 确保 任何 需 
用 到 代码 的 人 都 能 方便 地 使 用 这 些 测 试 。 RAE 
测试 和 代码 一 起 签 入 同一 个 代码 包 。 


对 ， 我 们 进步 甚 多 ; 但 还 有 很 长 的 路 要 走 。 敏 
捷 和 TDD 运 动 或 舞 了 许多 程序 员 编 写 目 动 化 单元 测 
试 ， 每 天 还 有 更 多 人 加 入 这 个 行列 。 但 是 ， 在 争先 
了 恐 后 将 测试 加 入 规程 中 时 ， 许 多 程序 员 遗 漏 了 一 些 
关于 编写 好 测试 的 更 细微 但 却 重 要 的 要 点 。 











9.1 TDD 三 定律 


谁 都 知道 TDD 要 求 我 们 在 编写 生产 代码 前 先 编 
写 单 元 测试 。 但 这 条 规则 只 是 冰山 之 题 。 看 看 下 列 
= E 


定律 一 “在 编写 不 能 通过 的 单元 测试 前 ， 不 
可 编写 生产 代码 。 


定律 二 ”只 可 编写 刚好 无 法 通过 的 单元 测 
试 ， 不 能 编译 也 算 不 通过 。 


定律 三 ”只 可 编写 刚好 足以 通过 当前 失败 测 
试 的 生产 代码 。 


这 三 条 定律 将 你 限制 在 大 概 30 秒 一 个 的 循环 
中 。 测 试 与 生产 代码 一 起 编写 ， 测 试 只 比 生 产 代 
AGES SLEDER o 


这 样 写 程序 ， 我 们 每 天 就 会 编写 数 十 个 测试 ， 
每 个 月 编写 数 百 个 测试 ， 每 年 编写 数 干 个 测试 。 这 
样 写 程 序 ， 测 试 将 上 履 囊 所 有 生产 代码 。 测 试 代 码 量 
足以 匹 政 生产 代码 量 ， 导 致 令 人 生长 的 管理 问题 。 





9.2 ”保持 测试 整洁 


几 年 前 ， 有 人 请 我 去 指导 一 个 开 及 团队 。 那 个 
团队 认定 ， 测 试 代码 的 维护 不 应 EIB AE Pe CES 
质量 标准 。 他 们 彼此 默许 在 单元 测试 中 破坏 规 
和 不。“ 速 而 不 周 * 成 了 团队 格言 。 变 量 命 名 不 用 好 ， 
测试 函数 不 必 短 小 和 具有 摘 述 性 。 测 试 代码 不 必 做 
民 好 设计 和 仔细 划分 。 只 要 测试 代码 还 能 工作 ， 只 
要 还 缆 凋 看 生产 代码 ， 束 足够 好 。 


有 些 读者 可 能 会 同意 这 种 人 做法。 或许， 在 很 久 
以 前 ， 你 也 用 过 我 为 那个 Timer 类 写 测 试 的 方法 。 
从 编写 那 种 用 后 即 扔 的 测试 到 编写 全 套 目 动 化 单元 
测试 是 一 大 进步 。 所 以 ， 束 像 那 个 我 指导 过 的 团队 
一 样 ， 你 或 许 也 会 认为 脏 测试 好 过 没 测 试 。 


这 个 团队 没有 意识 到 的 是 ， 脏 测试 等 同 于 
如 果 不 是 坏 于 的 话 没 测试 。 问 题 在 于 ， 测 试 必 
须 随 生 产 代码 的 演进 而 修改 。 测 试 越 脏 ， 就 越 难 修 
p. Duc. Vy n] Bede SS Ae ES] JH] E 
进 新 测试 ， 而 不 是 编写 新 生产 代码 。 修 改 生 产 代码 
后 ， 旧 测试 束 会 开始 失败 ， 而 测试 代码 中 乱七八糟 
的 东西 将 阻碍 代码 再 次 通过 。 于 是 ， 测 试 变 得 就 像 
是 不 断 翻 番 的 债务 。 
































随 腹 版 本 递 进 ， 团 队 维护 测试 代码 组 的 代价 也 
EEF. RE, CERI FREERK WER R. 
当 经 理 们 问 及 为 何 超 文 如 此 巨大 ， 开 发 者 们 就 归 答 
于 测试 。 最 后 ， 他 们 只 能 扔 挥 了 整个 测试 代码 组 。 


但 是 ， 没 有 了 测试 代码 组 ， 他 们 就 失去 了 确保 
对 代码 的 改动 能 如 愿 工 作 的 能 力 。 没 有 了 测试 代码 
组 ， 他 们 就 无 法 确保 对 系统 某 个 部 分 的 修改 不 会 影 
啊 到 系统 的 其 他 部 分 。 故 障 紊 开 始 增加 。 随 着 并 非 
出 上 自 有 意 的 故障 越 来 越 多 ， 他 们 开始 害怕 做 改动 。 
他 们 不 再 清理 生产 代码 ， 因 为 他 们 害怕 修改 带 来 的 
员 害 多 于 收益 。 生 产 代 码 开始 腐 坏 。 最 后 ， 他 们 只 
R Pi HA. Eu sb DATI TIS, IHE 
的 客户 ， 还 有 对 测试 的 失望 。 


在 茶 种 意义 上 ， 他 们 说 对 了 。 测 试 的 确 让 他 
们 失望 。 不 过 是 他 们 自己 决定 让 测试 变 得 乱 七 八 精 
的 ， 而 那 正 是 失败 的 根源 。 如 果 他 们 保持 测试 整 
lei» MANS TEE © BEY VATA A He HX A 
说 ， 因 为 我 几经 参与 并 指导 了 多 个 和 任 们 整洁 单元 
汕 斌 获得 成 功 的 团队 。 

故事 的 离 意 很 简单 : 训 试 代码 和 生产 代码 一 样 
重要 。 它 可 不 是 二 等 公民 。 它 需要 被 思考 、 锌 设 


计 和 被 照料 。 它 该 像 生产 代码 一 般 保持 整洁 。 




















测试 帝 来 一 切 好 处 


如 果 测 试 不 能 保持 整洁 ， 你 整 会 失去 它们 。 没 
有 了 测试 ， 你 就 会 失去 保证 生产 代码 可 扩展 的 一 切 
要 系 。 你 没 看 错 。 正 是 单元 测试 让 你 的 代码 可 扩 
展 、 可 维护 、 可 复 用 。 原 因 很 简单 。 有 了 测试 ， 你 
就 不 担心 对 代码 的 修改 ! 没有 测试 ， 每 次 修改 都 可 
Het RGR BE. TORR SAD FRE, Ave wit kat 
RAS, RA SMA, MR, BAK 
担忧 改动 会 引入 不 可 预知 的 缺陷 。 


有 了 测试 ， 秋 云 一 扫 而 空 。 测 试 履 兰 率 越 高 ， 
你 焉 越 不 担心 。 哪 但是 对 于 那 种 架构 并 不 优秀 、 设 
TFH U ERARA, PRERE PIA Jri E 
pk. SEINE, MSEE A ! 


PHV, f S EARI HI BL E SR cw 
组 能 尽 可 能 地 保持 设计 和 架构 的 整洁 。 测 斌 带 来 了 
一 切 好 处 ， 因 为 测试 使 改动 变 得 可 能 。 


如 果 测 试 不 和 干将， 你 改动 目 己 代 码 的 能 力 就 有 
所 牵制 ， 而 你 也 会 开始 失去 改进 代码 结构 的 能 
MU GOH, RAS BACT HE. w, MEK Sill 
试 ， 代 码 开始 腐 坏 。 























9.3 FAA Man 


整洁 的 测试 有 什么 要 素 ? 有 三 个 要 素 : 可 读 
性 ， 可 读 性 和 可 读 性 。 在 单元 测试 中 ， 可 读 性 其 至 
比 在 生产 代码 中 还 重要 。 测 试 如 何 才 能 做 到 可 读 ? 
和 其 他 代码 中 一 样 : 明确 ， 简 洁 ， 还 有 足够 的 表达 
力 。 在 测试 中 ， 你 要 以 尽 可 能 少 的 文学 表达 大 量 内 
容 。 





来 看 看 代码 清单 9-1 中 来 自 FitNesse 的 代码 。 这 
三 个 测试 很 难 读 懂 ， 显 然 有 改善 空间 。 首 先 ， 其 中 
有 数量 恐怖 的 重复 代码 [G5] 调 用 addPage 和 
assertSubString。 更 重要 的 是 ， 代 人 码 中 充满 了 于 扰 测 
试 表 达 力 的 细节 。 


代码 清单 9-1 SerializedPageResponderTest.java 











public void testGetPageHieratchyAsXml() throws Exception 


crawler.addPage(root, PathParser.parse("PageOne") ); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo") ); 


request.setResource("root"); 
request.addInput("type", "pages"); 
Responder responder - new SerializedPageResponder(); 
SimpleResponse response - 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent(); 


j 


assertEquals("text/xml", response.getContentType()); 
assertSubString("«name»PageOnec/name»", xml); 
assertSubString("<name>PageTwo</name>", xml); 
assertSubString("<name>ChildOne</name>", xml); 


public void testGetPageHieratchyAsXmlDoesntContainSymbolicLinks 


() 


throws Exception 


{ 


j 


WikiPage pageOne - crawler.addPage(root, PathParser.parse("Pag 
eOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 


crawler.addPage(root, PathParser.parse("PageTwo")); 


PageData data - pageOne.getData(); 
WikiPageProperties properties - data.getProperties(); 


WikiPageProperty symLinks - properties.set(SymbolicPage.PROPER 
TY. NAME) ; 


symLinks.set("SymPage", "PageTwo"); 
pageOne.commit(data); 


request.setResource("root"); 
request.addInput("type", "pages"); 
Responder responder - new SerializedPageResponder(); 
SimpleResponse response - 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent(); 


assertEquals("text/xml", response.getContentType()); 
assertSubString("«name»PageOnec/name»", xml); 
assertSubString("<name>PageTwo</name>", xml); 
assertSubString("<name>ChildOne</name>", xml); 
assertNotSubString("SymPage", xml); 


public void testGetDataAsHtml() throws Exception 


{ 


crawler.addPage(root, PathParser.parse("TestPageOne"), 


age"); 


request.setResource("TestPageOne" ); 
request.addInput("type", "data"); 
Responder responder = new SerializedPageResponder(); 


"test p 


SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent(); 


assertEquals("text/xml", response.getContentType()); 
assertSubString("test page", xml); 
assertSubString("«Test", xml); 





请 看 对 PathParser 的 那些 调用 。 它 们 将 字符 串 
转换 为 供 候 虫 使 用 的 PagePath 实 体 。 转 换 与 测试 毫 
无 天 系 ， 徒 然 混 消 了 代码 的 意图 。 与 创建 responder 
相关 的 细节 ， 还 有 response 的 收集 与 转换 也 尽 是 噪 
声 。 此 外 还 有 从 resource 和 参数 构造 请 求 UREL BJ A 





手段 。《〈 这 些 代 码 我 有 幸 参 与 编写 ， 所 以 可 以 属 开 
来 批评 。 ) 


最 终 ， 这 上 段 代 码 不 是 设计 来 给 人 看 的 。 可 怜 的 
读者 淹没 在 Lm 在 真正 用 到 测试 之 
前 ， 还 得 理解 这 些 细 市 


现在 看 看 代码 清单 9-2 中 改进 了 的 测试 。 
测试 还 是 做 一 样 的 事 ， 不 ih CLE MEL Hy A 
有 表达 力 的 形式 。 


代码 清单 9-2 SerializedPageResponderTest.java (#244 Ja) 








public void testGetPageHierarchyAsXml() throws Exception { 
makePages("PageOne", "PageOne.ChildOne", "PageTwo"); 


submitRequest("root", "type:pages"); 


assertResponseIsXML(); 
assertResponseContains( 
"<name>PageOne</name>", '"<name>PageTwo</name>", "«name»Chi 
1dOne</name>" 


); 


public void testSymbolicLinksAreNotInxmlPageHierarchy() throws 
Exception { 
WikiPage page = makePage("PageOne"); 
makePages("PageOne.ChildOne", "PageTwo"); 


addLinkTo(page, "PageTwo", "SymPage"); 
submitRequest("root", "type:pages"); 


assertResponseIsXML(); 
assertResponseContains( 
"<name>PageOne</name>", '"<name>PageTwo</name>", "«name»Chi 
1dOne</name>" 
); 
assertResponseDoesNotContain("SymPage"); 


j 


public void testGetDataAsXml() throws Exception ( 
makePageWithContent("TestPageOne", "test page"); 


submitRequest("TestPageOne", "type:data"); 


assertResponseIsXML(); 
assertResponseContains("test page", "«Test"); 


j 





这 些 测 试 显 然 呈现 了 构造 -操作 -检验 CBUILD- 
OPERATE-CHECK) 5] 模式 。 每 个 测试 都 清晰 地 
拆 分 为 三 个 环节 。 第 一 个 环 节 构造 测试 数据 ， 第 二 








个 环节 操作 测试 数据 ， 第 三 个 部 分 检验 操作 是 否 得 
到 期 望 的 结果 。 


注意 ， 那 些 恼 人 的 细 下 大 部 分 消失 了 。 测 试 直 
达 卓 的， 只 用 到 那些 真正 需要 的 数据 类 型 和 函数 。 
读 测 试 的 人 应 该 都 能 够 很 快 搞 清 楚 状 况 ， 不 至 于 被 
细 市 误导 或 吓 倒 。 


9.3.1 面 问 特定 领域 的 测试 语言 


代码 清单 9-2 中 的 训 斌 展示 了 为 测试 构造 一 种 
面 问 特定 领域 的 语言 的 技巧 。 我 们 没有 和 直接 使 用 程 
序 员 用 来 对 系统 进行 操作 的 API， 而 是 打造 了 一 套 
包 闻 这些 API 的 函数 和 工具 代码， 这 样 就 能 更 方便 
地 编写 测试 ， 写 出 来 的 测试 也 更 便于 阅读 。 那 正 是 
一 种 测试 语言 ， 可 以 帮助 程序 员 编 写 目 己 的 测 
试 ， 也 可 以 帮助 后 来 者 阅读 测试 。 


这 种 测试 API 并 非 起 初 就 设计 出 来 ， 而 是 在 对 
那些 元 满 令 人 迷惑 细节 的 测试 代码 进行 后 续 重 构 时 
逐渐 活 进 。 如 同 你 看 见 我 将 代码 清单 9-1 重 构 为 代 
人 码 清 单 9-2 一 般 ， 守 规矩 的 开发 者 也 将 他 们 的 测试 
代码 重 构 为 更 简洁 和 有 具有 表达 力 的 形式 。 


9.3.2 ”双重 标准 



































在 东 种 意义 上 ， 本 章 开 始 处 近 到 的 那个 团队 的 
做 法 是 正确 的 。 测 试 API 中 的 代码 与 生产 代码 相 
比 ， 的 确 有 一 套 不 同 的 工程 标准 。 测 试 代码 应 当 
人 简单、 精怪 、 足 具 表 达 力 ， 但 它 该 和 生产 代码 一 般 
AM FRE ce FEM Ap Be MEA PAA BGP IST 
这 两 种 环境 有 看 截然 不 同 的 需求 。 


请 看 代码 清单 9-3 中 的 测试 。 在 为 茶 个 环境 控 
制 系 统 设计 原型 时 ， 我 写 了 这 个 测试 。 无 需 深 入 细 
W, PRB HE Di H AMM AE “Ti SEAR” EY or Sor i, BEF 
thas. UA ae PIS XU Lr 3 ERA - 


代码 清单 9-3 EnvironmentControllerTest.java 








QTest 
public void turnOnLoTempAlarmAtThreashold() throws Exception { 
hw.setTemp(WAY TOO COLD); 
controller.tic(); 
assertTrue(hw.heaterState() 
assertTrue(hw.blowerState() 


assertFalse(hw.coolerState()); 
assertFalse(hw.hiTempAlarm()); 
assertTrue(hw.loTempAlarm() 





当然 ， 这 里 涉 也 有 许多 细 市 。 例 如 ，tic 函 数 古 
做 什么 的 ? 实际 上 ， 在 读 测 试 时 你 可 以 不 用 担心 这 
些 问题 。 你 只 需 考 碟 是 否 同意 系统 最 终 状 态 是 合 


与 “温度 太 低 ”的 情况 相符 。 








当 你 阅读 这 个 测试 时 ， 可 以 留意 到 自己 的 眼光 
得 在 被 检验 的 状态 的 名 称 与 状态 的 “意义 ”之 间 来 回 
跳 转 。 你 看 到 heaterState， 有 眼光 同 左 滑 到 
assertTrue. 你 看 到 coolerState， RENEA 
assertFalse. XX FERE ZIRA SE. "en A 
变 得 难以 阅读 。 


我 大 幅 改进 了 测试 的 可 读 性 ， 得 到 代码 清单 9- 





4。 


代码 清单 9-4 EnvironmentControllerTest.java (#44) Ja) 


QTest 
public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold(); 
assertEquals("HBchL", hw.getState()); 


j 





"AER, FREI f —^-wayTooColdPAZ&, KER I 
tic Pk n 数 的 细节 。 不 过 要 注意 的 是 assertEquals 中 的 那 
个 奇怪 的 字符 串 。 大 写 表示 “打开 ”， 小 写 表示 “ 关 
闭 ”， 那 些 字 符 遵 循 以 下 次 序 : (heater, blower, 
cooler, hi-temp-alarm, lo-temp-alarm} . 


管 这 破坏 了 思维 映射 A 的 规则 ， 看 来 它 在 
这 种 信 况 下 还 是 适用 的 。 diea 明白 其 含 》 ， 你 就 
能 一 眼看 到 那个 字符 串 ， 迅 速 译 解 出 结果 。 


代码 清单 9-5 EnvironmentControllerTest.java (47 JE FEK iG 
ED 


QTest 
public void turnOnCoolerAndBlowerIfTooHot() throws Exception { 
tooHot(); 
assertEquals("hBChl", hw.getState()); 


j 


QTest 
public void turnOnHeaterAndBlowerIfTooCold() throws Exception 


tooCold(); 
assertEquals("HBchl", hw.getState()); 
} 


QTest 

public void turnOnHiTempAlarmAtThreshold() throws Exception { 
wayTooHot( ); 
assertEquals("hBCHl", hw.getState()); 

} 


@Test 

public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold(); 
assertEquals("HBchL", hw.getState()); 


j 





代码 清单 9-6 中 给 出 了 getState 函 数 。 注 意 ， 代 
AE SEAN EAE TH eo BEGET BER, MY REMIZE H 
StringBuffer. 





代码 清单 9-6 MockControlHardware.java 





public String getState() { 
String state = ""; 
state += heater ? "H" : "h"; 


state += blower ? "B" : "b"; 

state += cooler ? "C" ; "gc"; 

state += hiTempAlarm ? "H" : "h"; 

state += loTempAlarm ? "L" : "1"; 
return state; 





StringBuffer S HIA. BEEE RAF, 
使 代价 较 小 ， 我 都 会 避免 使 用 StringBuffer; 而 且 你 
可 以 看 到 ， 清 单 9-6 中 代码 的 代价 的 确 很 小 。 这 和 套 
应 用 显然 是 散 入 式 实 时 系统 ， 计 算 机 和 内 存 资 源 都 
很 有 限 。 不 过 ， 测 试 环境 大 概 完全 不 必 做 限制 。 








这 就 是 双重 标准 。 有 些 事 你 大 概 永远 不 会 在 生 
产 环 境 中 做 ， 而 在 测试 环境 中 做 却 完全 没 问题 。 通 
和 这 关乎 内 存 或 CPU 效率 的 问题 ， 不 过 却 永远 不 会 
与 整洁 有 关 。 





9.4 每 个 测试 一 个 断言 


有 个 流派 OL 认 为 ，JUnit 中 每 个 测试 函数 都 应 
该 有 且 只 有 一 个 断言 语句 。 这 条 规则 看 似 过 于 奇 
求 ， 但 其 好 处 却 可 以 在 代码 清单 9-5 中 看 到 。 这 些 
测试 部 归结 为 一 个 可 快速 方便 地 理解 的 结论 。 


代码 清单 9-2 又 如 何 ? 我 们 能 将 关于 输出 是 
XML 的 断言 与 输出 包含 METRE 轻易 地 
组 合 到 一 起 ， 不 过 这 样 做 看 来 坚 无 道理 。 然 而 ， 我 
们 可 以 将 训 试 分 解 为 两 个 单独 的 测试 ， 每 个 都 有 目 
己 的 断言 ， 如 代码 清单 9-7 所 示 。 


代码 清单 9-7 SerializedPageResponderTest.java CEA Ir zi AY 
版 本 ) 











public void testGetPageHierarchyAsXml() throws Exception { 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 


whenRequestIsIssued("root", "type:pages"); 


thenResponseShouldBeXML(); 
} 


public void testGetPageHierarchyHasRightTags() throws Exception 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 
whenRequestIsIssued("root", "type:pages"); 


thenResponseShouldContain( 
"<name>PageOne</name>", '"<name>PageTwo</name>", "«name»Chi 


ldOne«c/name»" 
); 
} 


注意， 我 修改 了 那些 函数 的 名 称 ， 以 符合 
given-when-then ©! 约定 。 这 让 测试 更 易 阅 读 。 不 幸 
的 是 ， 如 此 分 解 测 试 ， 导 致 了 许多 重复 代码 的 出 
现 。 





可 以 利用 模板 方法 (TEMPLATE METHOD) 
川 模 式 ， 将 given/when 部 分 放 到 基 类 中 ， 将 then 部 
分 放 到 派生 类 中 ， 消 除 代 码 重 复 问题 。 或 者 ， 我 们 
也 可 以 创建 一 个 完整 的 单独 测试 类 ， 把 given 和 
when 部 分 放 到 @Before 函 数 中 ， 把 when 部 分 放 到 每 
个 @Test 函 数 中 。 但 对 于 这 个 小 问题 ， 这 看 来 有 点 
太 机 械 。 最 后 ， 我 还 是 保留 了 代码 清单 9-2 那 种 多 
个 断言 的 形式 。 


我 认为 ， 单 个 断言 是 个 好 准则 2 。 我 通常 都 
会 创建 文 持 这 条 准则 的 特定 领域 测试 语言 ， 如 代码 
消音 9-5 所 示 。 不 过 ， 我 也 不 害 介 在 单个 测试 中 放 
入 一 个 以 上 上 断言。 我 认为 ， 最 好 的 说 法 是 单个 测试 
中 的 断言 数量 应 该 最 小 化 。 


每 个 测试 一 个 概念 














更 好 一 些 的 规则 或 许 是 每 个 测试 函数 中 只 测试 
一 个 概念 。 我 们 不 想 要 超 长 的 测试 函数 ， 测 试 完 这 
个 又 测 试 那 个 。 代 人 码 清 单 9-8 就 是 那样 一 种 测试 的 
例子 。 这 个 测试 应 当 拆 解 为 3 个 单独 测试 ， 因 为 它 
测试 了 3 件 不 同 的 事 。 把 三 者 混 到 一 起 ， 读 者 束 不 
得 不 狂想 每 段 代 人 码 出 现 的 理由 ， 以 及 那 段 代码 到 底 
要 测试 什么 。 


代码 清单 9-8 


/** 
* Miscellaneous tests for the addMonths() method. 
nd d 
public void testAddMonths() { 
SerialDate d1 - SerialDate.createInstance(31, 5, 2004); 


SerialDate d2 - SerialDate.addMonths(1, d1); 
assertEquals(30, d2.getDayOfMonth()); 
assertEquals(6, d2.getMonth()); 
assertEquals(2004, d2.getYYYY()); 


SerialDate d3 - SerialDate.addMonths(2, d1); 


assertEquals(31, d3.getDayOfMonth()); 
assertEquals(7, d3.getMonth()); 
assertEquals(2004, d3.getYYYY()); 


SerialDate d4 = SerialDate.addMonths(1, SerialDate.addMonth 
d1)); 

assertEquals(30, d4.getDayOfMonth()); 

assertEquals(7, d4.getMonth()); 

assertEquals(2004, d4.getYYYY()); 





这 三 个 测试 函数 大 概 应 该 像 这 个 样子 : 





e 对 于 采 个 有 31 天 的 月 份 的 最 后 一 天 《如 五 
H): 


(1) 增加 一 个 该 月 份 最 末 一 天 为 30 日 (如 六 
Ho 的 月 份 时 ， 日 期 应 该 是 该 月 的 30 日 而 非 31 日 。 


(2) 增加 最 末 月 有 31 天 的 两 个 月 时 ， 日 期 应 
该 是 31 日 。 


。 对 于 某 个 有 30 天 的 月 份 的 最 后 一 天 《如 六 
月 ) : 


(3) 增加 一 个 有 31 天 的 月 份 时 ， 日 期 应 该 是 
30 日 而 非 31 日 。 


这 样 一 来 ， 你 可 以 看 到 ， 在 这 些 混 末 的 测试 当 
中 ， 隐 藏 有 一 条 普 届 规则 。 增 加 月 份 数 时 ， 日 期 不 
能 大 于 该 月 份 的 最 来 一天。 这 意味 痢 在 2 月 28 日 增 
加 月 份 数 ， 就 会 得 到 3 月 28 日 。 而 这 个 测试 应 该 有 
Hi. (Bass y. 


并 非 是 代码 清单 9-8 中 每 个 段落 的 多 重 断 言 导 
Mel. HME, ASPB MIA, ATA, Be 
佳 规 则 也 许 是 应 该 尽 可 能 减少 每 个 概念 的 断言 数 
量 ， 每 个 测试 函数 只 测试 一 个 概念 。 




















95 E.LR.S.T. [9] 


整洁 的 测试 还 遭 循 以 下 5 条 规则 ， 这 5 条 规则 的 
首 字 母 构 成 了 本 节 标 题 : 


快速 (Fast) ”测试 应 该 够 快 。 测 试 应 该 能 快 
速 运行 。 训 试 运 行 缓慢 ， 你 就 不 会 想 要 频 楷 地 运行 
它 。 如 果 你 不 频 营 运行 测试 ， 就 不 能 尽早 友 现 问 
题 ， 也 无 法 轻易 修正 ， 从 而 也 不 能 轻而易举 地 清理 
WS. RA, FUERTE N 


独立 (Independent) ”测试 应 该 相互 独 这 。 某 
个 测试 不 应 为 下 一 个 测试 设 定 条 件 。 你 应 该 可 以 单 
独 运 行 每 个 测试 ， 及 以 任何 顺序 运行 测试 。 当 测试 
互相 依赖 时 ， 头 一 个 没 通 过 残 会 导致 一 连 串 的 测试 
和 失败， 使 问题 诊断 变 得 困难 ， 隐 藏 了 下 级 错误 。 


可 重复 〈Repeatable) 测试 应 当 可 在 任何 环 
境 中 重复 通过 。 你 应 该 能 够 在 生产 环境 、 质 检 环 境 
中 运行 测试 ， 也 能 够 在 无 网 络 的 列车 上 用 笔记 本 电 
脑 运行 测试 。 如 采 测 试 不 能 在 任意 环境 中 重复 ， 你 
HRSA MATER AMINO. SARA 
时 ， 你 也 会 无 法 运行 测试 。 


























自足 验证 (Self-Validating) ”测试 应 该 有 布 
尔 值 输出 。 无 论 是 通过 或 失败 ， 你 不 应 该 得 看 日 志 
文件 来 确认 测试 是 个 通 过 。 你 不 应 该 手工 对 比 两 个 
不 同文 本 文件 来 确认 测试 是 否 通过 。 如 采 测 试 不 能 
目 足 验证 ， 对 失败 的 判断 束 会 变 得 依赖 主观 ， 而 运 
行 测 试 也 需要 更 长 的 手工 操作 时 间 。 


及 时 (Timely) 测试 应 及 时 编写 。 单 元 测试 
应 该 恰好 在 使 其 通过 的 生产 代码 之 前 编写 。 如 果 在 
编写 生产 代码 之 后 编写 测试 ， 你 会 发 现 生产 代码 难 
以 测试 。 你 可 能 会 认为 某 些 生 产 代码 本 里 难以 测 
试 。 你 可 能 不 会 去 设计 可 测试 的 代码 。 














9.6 ”小结 


我 们 只 是 触及 了 这 个 话题 的 表面 。 实 际 上 ， 我 
认为 应 该 为 整洁 的 测试 写 上 一 整 本 书 。 对 于 项 目的 
健康 上 度 ， 测 试 合生 产 代码 同等 重要 。 或 许 测 试 更 为 
重要 ， 因 为 它 保证 和 增强 了 生产 代码 的 可 扩展 性 、 
可 维护 性 和 可 复 用 性 。 所 以 ， 你 持 测 试 整洁 吧 。 让 
测试 具有 表达 力 并 短小 精怪 。 及 明 作 为 面 问 特定 领 
域 语言 的 测试 API， 和 帮助 目 己 编写 测试 。 


如 果 你 坐视 测试 腐 坏 ， 那 么 代码 也 会 跟着 腐 
十。 你 持 测 试 整 涪 吧 。 
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本 书 到 目前 为 止 一 直 在 讨论 如 何 编写 民 好 的 代 
人 码 行 和 代码 块 。 我 们 深入 研究 了 函数 的 恰当 构成 ， 
以 及 函数 之 间 如 何 互 相关 联 。 不 过 ， 尺 管 讨论 了 这 
么 多 天 于 代码 语句 及 由 代码 语句 构成 的 函数 的 表达 
力 ， 除 非 我 们 将 注意 力 放 到 代码 组 织 的 更 高 层面 ， 
就 始终 不 能 得 到 整洁 的 代码 。 








10.1 类 的 组 织 


遵循 标准 的 Java 约 定 ， 类 应 该 从 一 组 变量 列表 
开始 。 如 果 有 公共 静态 常量 ， 应 该 先 出 现 。 然 后 是 
A RAS, URMA KATE. (RDS A AE 


变量 。 


公共 函数 应 跟 在 变量 列表 之 后 。 我 们 喜欢 把 由 
某 个 公共 函数 调用 的 私有 工具 函数 紧 随 在 该 公共 函 
数 后 面 。 这 符合 了 目 顶 癌 下 原则 ， 让 程序 读 起 来 就 
像 一 篇 报纸 文章 。 


BIA 


我 们 喜欢 保持 变量 和 工具 函数 的 私有 性 ， 但 并 
不 执 看 于 此 。 有 时 ， 我 们 也 需要 用 到 爱护 
(protected) 变量 或 工具 孔 数 ， 好 让 测试 可 以 访问 
到 。 对 我 们 来 说， 测试 说 了 算 。 和 大 同一 程序 包 内 的 
某 个 测试 需要 调用 一 个 函数 或 变量 ， 我 们 束 会 将 该 
函数 或 变量 置 为 受 护 或 在 整个 程序 包 内 可 访问 。 然 
而 ， 我 们 首先 会 想 办 法 使 之 保有 隐私 。 放 松 封装 总 
AE. 




















10.2 ”类 应 该 短小 


关于 类 的 第 一 条 规则 是 类 应 该 短小 。 第 二 条 规 
则 是 还 要 更 短小 。 不 ， 我 们 并 不 是 要 重 弹 “ 函 数 "一 
EN. BRR, FEW, BER 
残 是 要 更 短小 。 和 函数 一 样 ， 马 上 有 个 问题 出 现 ， 
那 束 是 “多 小 合适 呢 ?” 

对 于 函数 ， 我 们 通过 计算 代码 行 数 衡量 大 小 。 
对 于 类 ， 我 们 采用 不 同 的 衡量 方法 ， 计 算 权 贡 
(responsibility) H 。 

代码 清单 10-1 给 出 了 茶 个 类 的 轮廓 。 
SuperDashboard 类 曝露 大 概 70 个 公共 方法 。 大 多 数 
开发 者 都 会 同意 ， 这 实在 是 太 长 了 。 有 些 开发 者 或 


许 会 将 SuperDashboard 类 指 为 “ 神 的 类 ”。 


代码 清单 10-1 NEKE 




















public class SuperDashboard extends JFrame implements MetaDataU 
ser 
public String getCustomizerLanguagePath() 
public void setSystemConfigPath(String systemConfigPath) 
public String getSystemConfigDocument() 
public void setSystemConfigDocument(String systemConfigDocum 


public boolean getGuruState() 
public boolean getNoviceState() 
public boolean getOpenSourceState() 


me ) 


t) 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


public 
public 
public 
public 
public 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


void showObject(MetaObject object) 

void showProgress(String s) 

boolean isMetadataDirty() 

void setIsMetadataDirty(boolean isMetadataDirty) 
Component getLastFocusedComponent( ) 

void setLastFocused(Component lastFocused) 

void setMouseSelectState(boolean isMouseSelected) 
boolean isMouseSelected() 

LanguageManager getLanguageManager( ) 

Project getProject() 

Project getFirstProject() 

Project getLastProject() 

String getNewProjectName( ) 

void setComponentSizes(Dimension dim) 

String getCurrentDir() 

void setCurrentDir(String newDir) 

void updateStatus(int dotPos, int markPos) 
Class[] getDataBaseClasses() 

MetadataFeeder getMetadataFeeder() 

void addProject(Project project) 

boolean setCurrentProject(Project project) 
boolean removeProject(Project project) 
MetaProjectHeader getProgramMetadata( ) 

void resetDashboard() 

Project loadProject(String fileName, String projectNa 


void setCanSaveMetadata(boolean canSave) 

MetaObject getSelectedObject() 

void deselectObjects() 

void setProject(Project project) 

void editorAction(String actionName, ActionEvent even 


void setMode(int mode) 

FileManager getFileManager() 

void setFileManager(FileManager fileManager) 
ConfigManager getConfigManager() 

void setConfigManager(ConfigManager configManager ) 
ClassLoader getClassLoader() 

void setClassLoader(ClassLoader classLoader) 
Properties getProps() 

String getUserHome( ) 

String getBaseDir() 

int getMajorVersionNumber ( ) 

int getMinorVersionNumber ( ) 

int getBuildNumber () 


public 


MetaObject pasting( 


MetaObject target, MetaObject pasted, MetaProject project 


public 
public 
public 
public 
public 
public 
ndex) 
public 
public 
public 
public 
ng) 
public 
public 
public 
public 
public 
public 
public 
public 
yName) 
// 


j 


void processMenuItems(MetaObject metaObject) 

void processMenuSeparators(MetaObject metaObject) 
void processTabPages(MetaObject metaObject) 

void processPlacement(MetaObject object) 

void processCreateLayout(MetaObject object) 

void updateDisplayLayer(MetaObject object, int layerI 


void propertyEditedRepaint(MetaObject object) 

void processDeleteObject(MetaObject object) 

boolean getAttachedToDesigner() 

void processProjectChangedState(boolean hasProjectCha 


void processObjectNameChanged(MetaObject object) 

void runProject() 

void setAcowDragging(boolean allowDragging) 

boolean allowDragging() 

boolean isCustomizing() 

void setTitle(String title) 

IdeMenuBar getIdeMenuBar ( ) 

void showHelper(MetaObject metaObject, String propert 


. many non-public methods follow ... 





如 条 SuperDashboard 类 只 包括 代码 清单 10-2 中 


的 方法 呢 ? 





代码 清单 10-2 ”足够 短小 了 吗 ? 





public class SuperDashboard extends JFrame implements MetaDataU 
ser{ 
public Component getLastFocusedComponent( ) 
public void setLastFocused(Component lastFocused) 
public int getMajorVersionNumber ( ) 
public int getMinorVersionNumber ( ) 
public int getBuildNumber ( ) 


5 个 方法 不 算 多 ， 在 这 里 ， 虽 然 方法 数量 较 
少 ， 可 SuperDashboard 还 是 拥有 太 多 权 贡 。 


类 的 名 称 应 当 摘 述 其 权 贡 。 实 际 上 ， 命 名 正 古 
帮助 判断 类 的 长 度 的 第 一 个 手段 。 如 采 无 法 为 采 个 
类 命 以 精确 的 名 称 ， 这 个 类 大 概 就 太 长 了 。 类 名 越 
含混 ， 该 类 越 有 可 能 拥有 过 多 权 员 。 例 如 ， 如 果 类 
名 中 包括 含义 模糊 的 词 ， 如 Processor 或 Manager 或 
Super， 这 种 现象 往往 说 明 有 不 恰当 的 权 员 聚集 情 
况 存 在 。 


我 们 也 应 该 能 够 用 大 概 25 个 单词 简要 描述 一 个 
Jey BAHE OD S G Cand): *, "R 
Cor) ”或 者 “但 (but) ?等 词汇 。 我 们 该 如 何 描述 
SuperDashboard 类 呢 ?“SuperDashboard 类 提供 了 对 
最 后 拥有 焦点 的 组 件 的 访问 能 力 ， 我 们 还 能 通过 它 
跟踪 版 本 号 和 构建 序列 号 。”“ 还 能 ”二 字 正 好 提示 
J SuperDashboard# Ff A 4M Gt» 


10.2.1 单一 权 责 原则 


单一 权 责 原则 (SRP) 21 认为 ， 类 或 模块 应 有 
且 只 有 一 条 加 以 修改 的 理由 。 该 原则 既 给 出 了 权 














责 的 定义 ， 又 是 关于 类 的 长 度 的 指导 方针 。 类 只 应 
有 一 个 权 责 一 只 有 一 条 修改 的 理由 。 


代码 清单 10-2 中 貌似 很 小 的 SuperDashboard 类 
有 两 条 加 以 修改 的 理由 。 首 先 ， 它 跟踪 大 概 会 随 软 
件 每 次 发 布 而 更 新 的 厂 本 信息 。 第 二 ， 它 管理 Java 
Swing 组 件 ( 派 生日 JFrame， 顶 层 GUI 和 窗口 的 Swing 
表现 形态 ) 。 每 次 修改 Swing 代 人 码 时 ， 无 疑 都 要 更 
PMA S, (AR ZAM AT: 也 可 能 依据 系统 中 其 
他 代码 的 修改 而 更 新 版 本 信息 。 


鉴别 权 责 (修改 的 理由 ) 常常 帮助 我 们 在 代码 
中 认识 到 并 创建 出 更 好 的 抽象 。 可 以 轻易 地 将 全 部 
三 个 处 理 版 本 信息 的 SuperDashboard 方 法 拆 解 到 名 
为 Version 的 类 中 (如 代码 清单 10-3 所 示 ) o Version 
类 是 个 极 有 可 能 在 其 他 应 用 程序 中 得 到 复 用 的 构 


X! 











代码 清单 10-3 单一 权 责 类 


public class Version { 
public int getMajorVersionNumber ( ) 
public int getMinorVersionNumber ( ) 
public int getBuildNumber ( ) 





SRP 是 OO 设计 中 最 为 重要 的 概念 之 一 ， 也 是 较 





为 容易 理解 和 胜 循 的 概念 乙 一 。 柯 怪 的 是 SRP 往 往 
也 是 最 容易 被 破坏 的 类 设计 原则 。 经 第 会 遇 到 做 太 
多 事 的 类 。 为 什么 呢 ? 


让 软件 能 工作 和 让 软件 保持 整洁 ， 是 两 种 截然 
不 同 的 工作 。 我 们 中 的 大 多 数 人 脑力 有 限 ， 只 能 更 
多 地 把 精力 放 在 让 代码 能 工作 上 ， 而 不 是 放 在 保持 
代码 有 组 织 和 整洁 上 。 这 全 然 正 确 。 分 而 治之 ， 其 
eS eae eee ree 
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了 。 我 们 没 能 把 思维 转岗 有关 代码 组 织 和 整洁 的 部 
分 。 我 们 和 直接 转 癌 下 一 个 问题 ， 而 不 是 回头 将 及 有 种 
的 关切 分 为 只 有 单一 权 责 的 去 三 式 单 元 。 


与 此 同时 ， 许 多 开发 者 害怕 数量 巨大 的 短小 单 
一 目的 类 会 导致 难以 一 目 了 然 抓 住 全 局 。 他 们 认 
为 ， 要 岳 消 楚 一 件 较 大 工作 如 何 完 成 ， 束 得 在 类 与 
类 之 间 找 来 找 去 。 


然而 ， 有 大 量 短小 类 的 系统 并 不 比 有 少量 庞大 
类 的 系统 拥有 更 多 移动 部 件 ， 其 数量 大 致 相等 。 问 
ze: 你 是 想 把 工具 归 置 到 有 许多 抽 敢 、 每 个 抽 导 
中 装 有 定义 和 标记 良好 的 组 件 的 工具 箱 中 呢 ， 还 是 
想 要 少数 儿 个 能 随便 把 所 有 东西 扔 进去 的 抽 屠 ? 









































每 个 达到 一 定 规模 的 系统 都 会 包括 大 量 逻 辑 和 
复杂 性 。 知 理 这 种 复杂 性 的 首要 目标 就 是 加 以 组 
织 ， 以 便 开 发 者 知 直 到 哪儿 能 找到 东西 ， 并 且 在 茶 
个 特定 时 间 只 需要 理解 直接 有 关 的 复杂 性 。 反 之 ， 
拥有 巨大 、 多 目的 类 的 系统 ， 总 是 让 我 们 在 目前 并 
不 需要 了 解 的 一 大 扒 东 西 中 艰难 跋涉 。 


再 强调 一 下 : 系统 应 该 由 许多 短小 的 类 而 不 是 
少量 巳 大 的 类 组 成 。 每 个 小 类 封装 一 个 权 贡 ， 只 有 
一 个 修改 的 原因 ， 并 与 少数 其 他 类 一 起 协同 达成 期 
望 的 系统 行为 。 











10.2.2 A# 


类 应 该 只 有 少量 实体 变量 。 类 中 的 每 个 方法 都 
应 该 操作 一 个 或 多 个 这 种 变量 。 通 第 而 言 ， 方 法 操 
作 的 变量 越 多 ， 束 越 颖 聚 到 类 上 。 如 果 一 个 类 中 的 
每 个 变量 都 被 每 个 方法 所 使 用 ， 则 该 类 具有 最 大 的 
ARIE- 
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局 位 置 。 内 聚 性 高 ， 意 味 着 类 中 的 方法 和 变量 互相 
依赖 、 互 相 结合 成 一 个 馆 辑 整体 。 


看 看 代码 清单 10-4 中 一 个 Stack 类 的 实现 方式 。 
































这 个 类 非常 内 聚 。 在 三 个 方法 中 ， 只 有 size( ) 方 法 
没有 使 用 所 有 两 个 变量 。 


代码 清单 10-4 Stack.java〈 一 个 内 聚 类 ) 


public class Stack ( 
private int topOfStack ; 
List<Integer> elements new LinkedList<Integer>(); 


public int size() { 
return topOfStack; 


public void push(int element) { 
topOfStack++; 
elements.add(element); 


public int pop() throws PoppedWhenEmpty { 
if (topOfStack -- 0) 
throw new PoppedWhenEmpty(); 
int element - elements.get(--topOfStack); 
elements.remove(topOfStack); 
return element; 





保持 函数 和 参数 列表 短小 的 末 略 ， 有 时 会 导致 
为 一 组 子 集 方 法 所 用 的 实体 变量 数量 增加 。 出 现 这 
种 情况 时 ， 往 往 意味 着 至 少 有 一 个 类 要 从 大 关中 掉 
扎 出 来 。 你 应 当 答 试 将 这 些 变量 和 方法 分 拆 到 两 个 
或 多 个 类 中 ， 让 新 的 类 更 为 内 聚 。 


10.2.3 ”保持 内 聚 性 束 会 得 到 许多 短小 的 类 








仅仅 是 将 较 大 的 函数 切割 为 小 函数 ， 束 将 导致 
更 多 的 类 出 现 。 想 想 看 一 个 有 许多 变量 的 大 函数 。 
你 想 把 该 函数 中 某 一 小 部 分 拆 解 成 单独 的 函数 。 不 
过 ， 你 想 要 拆 出 来 的 代码 使 用 了 该 函数 中 声明 的 4 
个 变量 。 是 否 必须 将 这 4 个 变量 都 作为 参数 传递 到 
新 函数 中 去 呢 ? 


完全 没 必 要 ! 只 要 将 4 个 变量 提升 为 类 的 实体 
变量 ， 完 全 无 需 传 递 任 何 变量 就 能 拆 解 代 码 了 。 
应 该 很 容易 将 函数 拆 分 为 小 块 。 


可 惜 这 也 意味 痢 类 丧失 了 内 聚 性 ， 因 为 堆积 了 
越 来 越 多 只 为 允许 少 量 函 数 共 主 而 存在 的 实体 变 
量 。 等 一 下 ! 如 果 有 些 函 数 想 要 共 且 东 些 变量 ， 为 
什么 不 让 它们 拥有 目 己 的 类 呢 ? SIKRER T AR 
PE, NUR! 


所 以 ， 将 大 函数 拆 为 许多 小 函数 ， 往 往 也 是 将 
类 拆 分 为 多 个 小 类 的 时 机 。 程 序 会 更 加 有 组 织 ， 也 
会 拥有 更 为 透明 的 结构 。 


为 了 说 明 我 的 意思 ， 不 如 从 Knuth 的 名 著 
Literate Programming (中 译 版 《字面 编程 》) D! 
中 摘 取 一 个 经 过 时 间 考 验 的 例子 。 代 码 清单 10-5 展 
示 了 Knuth 的 PrintPrimes 程 序 的 Java 版 本 。 为 示 公 
平 ， 以 下 程序 并 非 Knuth 原 版 ， 而 是 用 他 的 WEB 工 
































上 输出 的 版 本 。 采 用 它 作 为 例子 的 目的 ， 是 因为 它 
是 展示 如 何 将 较 大 的 函数 分 解 为 多 个 较 小 的 函数 和 
类 的 极 好 入 手 后 。 


代码 清单 10-5 PrintPrimes.java 





package literatePrimes; 


public class PrintPrimes { 
public static void main(String[] args) { 

final int M - 1000; 
final int RR 50; 
final int CC 4; 
final int W = 10; 
final int ORDMAX = 30; 
int P[] = new int[M + 1]; 
int PAGENUMBER; 
int PAGEOFFSET; 
int ROWOFFSET; 


int K; 

boolean JPRIME; 

int ORD; 

int SQUARE; 

int N; 

int MULT[] = new int[ORDMAX + 1]; 


SQUARE - 9; 


while (K < M) { 
do ( 
Je ux 
if (J 5 -- SQUARE) { 
ORD = ORD + 1; 
SQUARE - P[ORD] * a 
MULT[ORD - 1] = 


} 
N = 2; 
JPRIME = true; 
while (N < ORD && JPRIME) { 
while (MULT[N] < J) 
MULT[N] = MULT[N] + P[N] + P[N]; 
if (MULT[N] == J) 
JPRIME = false; 
N=N + 4; 


} 
) while (!JPRIME); 


K=K +1: 
P[K] = J; 

} 

{ 
PAGENUMBER = 1; 
PAGEOFFSET = 1; 


while (PAGEOFFSET <= M) { 
System.out.println("The First " + M + 
" Prime Numbers --- Page " + PAGENUM 
BER); 
System.out.println(""); 
for (ROWOFFSET = PAGEOFFSET; ROWOFFSET < PAGEOFFSET + RR; 
ROWOFFSET++) { 
for (C = 0; C < CC;C++) 
if (ROWOFFSET + C * RR <= M) 
System.out.format("%10d", P[ROWOFFSET + C * RR]); 
System.out.println(""); 
} 
System.out.println("Nf"); 
PAGENUMBER = PAGENUMBER + 1; 
PAGEOFFSET = PAGEOFFSET + RR * CC; 
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至 少 应 该 将 其 拆 分 为 数 个 较 小 的 函数 。 





从 代码 清单 10-6 到 代码 清单 10-8， 展 示 了 将 代 
码 清单 10-5 中 的 代码 拆 分 为 较 小 的 类 和 函数 ， 并 为 
这 些 类 、 函 数 和 变量 取 个 好 名 字 后 的 结 琳 。 


代码 清单 10-6 PrimePrinterjava 〈 重 构 后 ) 


package literatePrimes; 


public class PrimePrinter ( 
public static void main(String[] args) { 
final int NUMBER OF PRIMES - 1000; 
int[] primes = PrimeGenerator.generate(NUMBER OF. PRIMES); 


final int ROWS PER PAGE - 50; 
final int COLUMNS PER PAGE = 4; 
RowColumnPagePrinter tablePrinter - 
new RowColumnPagePrinter(ROWS PER PAGE, 
COLUMNS PER PAGE, 
"The First " + NUMBER OF PRIMES + 


" Prime Numbers"); 
tablePrinter.print(primes); 
} 
} 





代码 清单 10-7 RowColumnPagePrinter.java 





package literatePrimes; 


import java.io.PrintStream; 


public class RowColumnPagePrinter { 
private int rowsPerPage; 
private int columnsPerPage; 
private int numbersPerPage; 
private String pageHeader; 
private PrintStream printStream; 


public RowColumnPagePrinter(int rowsPerPage, 
int columnsPerPage, 
String pageHeader) ( 
this.rowsPerPage - rowsPerPage; 
this.columnsPerPage - columnsPerPage; 
this.pageHeader - pageHeader; 
numbersPerPage - rowsPerPage * columnsPerPage; 
printStream = System.out; 


j 


public void print(int data[]) { 
int pageNumber - 1; 
for (int firstIndexOnPage = 0; 
firstIndexOnPage < data.length; 
firstIndexOnPage += numbersPerPage) { 
int lastIndexOnPage = 
Math.min(firstIndexOnPage + numbersPerPage - 1, 
data.length - 1); 
printPageHeader(pageHeader, pageNumber); 
printPage(firstIndexOnPage, lastIndexOnPage, data); 
printStream.println("Nf"); 
pageNumber++; 
} 
} 


private void printPage(int firstIndexOnPage, 
int lastIndexOnPage, 
int[] data) { 
int firstIndexOfLastRowOnPage - 
firstIndexOnPage + rowsPerPage - 1; 
for (int firstIndexInRow = firstIndexOnPage; 
firstIndexInRow <= firstIndexOfLastRowOnPage; 
firstIndexInRow++) { 
printRow(firstIndexInRow, lastIndexOnPage, data); 
printStream.println(""); 


j 
2 


private void printRow(int firstIndexInRow, 
int lastIndexOnPage, 
int[] data) { 


for (int column = 0; column < columnsPerPage; column++) { 


int index = firstIndexInRow + column * rowsPerPage; 
if (index «- lastIndexOnPage) 
printStream.format("%10d", data[index]); 


j 
j 


private void printPageHeader(String pageHeader, 
int pageNumber) ( 
printStream.println(pageHeader + " --- Page " + pageNumber); 
printStream.println(""); 


j 


public void setOutput(PrintStream printStream) { 
this.printStream - printStream; 
} 


} 





代码 清单 10-8 PrimeGenerator.java 





package literatePrimes; 


import java.util.ArrayList; 


public class PrimeGenerator ( 
private static int[] primes; 
private static ArrayList«Integer» multiplesOfPrimeFactors; 


protected static int[] generate(int n) ( 
primes - new int[n]; 
multiplesOfPrimeFactors = new ArrayList«Integer»(); 
set2AsFirstPrime(); 
checkoddNumbersForSubsequentPrimes(); 
return primes; 


j 


private static void set2AsFirstPrime() ( 
primes[0] - 2; 
multiplesOfPrimeFactors.add(2); 

} 


private static void checkOddNumbersForSubsequentPrimes() { 
int primeIndex = 1; 
for (int candidate = 3; 
primelndex < primes.length; 
candidate += 2) ( 


if (isPrime(candidate)) 
primes[primeIndex++] = candidate; 
à 
} 


private static boolean isPrime(int candidate) { 
if (isLeastRelevantMultipleOfNextLargerPrimeFactor(candidate 
)) 4 
multiplesOfPrimeFactors.add(candidate); 
return false; 


j 


return isNotMultipleOfAnyPreviousPrimeFactor(candidate); 


j 


private static boolean 
isLeastRelevantMultipleOfNextLargerPrimeFactor(int candidate) 


{ 


int nextLargerPrimeFactor = primes[multiplesOfPrimeFactors.s 


ize()]; 
int leastRelevantMultiple - nextLargerPrimeFactor * nextLarg 
erPrimeFactor; 
return candidate -- leastRelevantMultiple; 
} 


private static boolean 
isNotMultipleOfAnyPreviousPrimeFactor(int candidate) { 
for (int n = 1; n « multiplesOfPrimeFactors.size(); n++) { 
if (isMultipleOfNthPrimeFactor(candidate, n)) 
return false; 


j 


return true; 


j 


private static boolean 
isMultipleOfNthPrimeFactor(int candidate, int n) { 
return 
candidate -- smallestOddNthMultipleNotLessThanCandidate(ca 
ndidate, n); 


j 


private static int 
smallestOddNthMultipleNotLessThanCandidate(int candidate, int 
n) { 
int multiple - multiplesOfPrimeFactors.get(n); 
while (multiple « candidate) 


multiple += 2 * primes[n]; 
multiplesOfPrimeFactors.set(n, multiple); 
return multiple; 
} 
} 





你 可 能 注意 到 的 第 一 件 事 就 是 程 友 比 原来 长 了 
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其 一 ， 重 构 后 的 程序 采用 了 更 长 、 更 有 描述 性 的 变 
量 名 。 其 二 ， 重 构 后 的 程序 将 函数 和 类 声明 当 作 是 
给 代码 添加 注释 的 一 种 手段 。 其 三， 我们 采用 了 至 
格 和 格式 技巧 让 程序 更 可 读 。 


留意 程序 是 如 何 被 拆 分 为 3 个 主要 权 责 的 。 
PrimePrinter 类 中 只 有 主 程序 。 主 程序 的 权 员 是 人 处理 
执行 环境 。 如 果 调 用 方式 改变 ， 它 也 会 随 之 改变 。 
例如 ， 如 果 程 序 被 转换 为 SOAP 服 务 ， 则 该 类 也 会 
DEADE 


RowColumnPagePrinter 类 懂得 如 何 将 数字 列表 
格式 化 到 有 看 固定 行 、 列 数 的 页 面 上 。 帮 输出 格式 
需要 改动 ， 则 该 类 也 会 被 影响 到 。 


PrimeGenerator 类 人 异 得 如 何 生 成 系数 列表 。 注 
意 ， 这 并 不 意味 着 要 实体 化 为 对 象 。 访 类 束 是 个 有 
用 的 作用 域 ， 在 其 中 声明 并 隐藏 变量 。 如 果 计 算 素 
数 的 算法 发 生 改动 ， 则 该 类 也 会 改动 。 





























这 并 不 算是 重 写 ! JU me NETS 8 
序 。 实 际 上 ， 如 果 你 仔细 看 上 述 两 个 不 同 的 程序 ， 
pen 





我 们 通过 编写 验证 第 一 个 程序 的 精确 行为 的 
用 例 来 实现 修改 。 然 后 ， 我 们 做 了 许多 小 改动 ， 
次 改动 一 处 。 每 改动 一 次 ， 就 执行 一 次 ， 确 保 程序 
的 行为 没有 变化 。 一 小 步 接着 一 小 步 ， 第 一 个 程序 
被 逐渐 清理 和 转换 为 第 二 个 程序 。 





10.3 为 了 修改 而 组 织 


对 于 多 数 系统 ， 修 改 将 一 下 持续 。 每 处 修改 都 
让 我 们 冒 着 系统 其 他 部 分 不 能 如 期 望 般 工 作 的 风 
险 。 在 整洁 的 系统 中 ， 我 们 对 类 加 以 组 织 ， 以 降低 
修改 的 风险 。 


代码 清单 10-9 中 的 Sql 类 用 来 生成 提供 恰当 元 数 
据 的 SQL 格式 化 字符 串 。 这 个 类 还 没 写 完 ， 所 以 暂 
时 不 支持 update 语 句 等 SQL 功能 。 当 需要 Sql 类 支持 
update 语 句 时 ， 我 们 就 得 “打开 ”这 个 类 进行 修改 。 
打开 类 和 帝 来 的 问题 是 风险 随 之 而 来 。 对 类 的 任何 修 
改 都 有 可 能 破坏 类 中 的 其 他 代码 。 必 须 全 面 重 新 测 
试 。 








代码 清单 10-9 一 个 必须 打开 修改 的 类 





public class Sql { 

public Sql(String table, Column[] columns) 

public String create() 

public String insert(Object[] fields) 

public String selectAll() 

public String findByKey(String keyColumn, String keyValue) 

public String select(Column column, String pattern) 

public String select(Criteria criteria) 

public String preparedInsert() 

private String columnList(Column[] columns) 

private String valuesList(Object[] fields, final Column[] co 
lumns) 

private String selectWithCriteria(String criteria) 

private String placeholderList(Column[] columns) 


当 增 加 一 种 新 语句 类 型 时 ， 束 要 修改 Sql 类 。 
改动 单个 语句 类 型 时 ， 也 要 进行 修改 ， 比 如 打算 让 
select 功 能 文 持 子 查 询 。 存 在 两 个 修改 的 理由 ， 说 明 
Sql 违反 了 SRP 原 则 。 


可 以 从 一 条 简单 的 组 织 性 观点 发 现 对 SRP 的 违 
反 。Sql 的 方法 大 纲 显 示 ， 存 在 次 似 
selectWithCriteria 等 只 与 select 语 句 有 关 的 私有 方 
Da 








出 现 了 只 与 类 的 一 小 部 分 有 关 的 私有 方法 行 
为 ， 意 味 着 存在 改进 空间 。 然 而 ， 展 开行 动 的 基本 
动因 却 应 该 是 系统 的 变动 。 若 我 们 认为 Sql 类 在 逻 
辑 上 已 具足 ， 则 无 需 担 心 对 权 责 的 拆 分 。 如 果 在 可 
预见 的 未 来 无 需 增 加 update 功 能 ， 就 该 不 去 动 Sql 
2S. Nit, -—BFA SA, DWN ERHI Ro 


代码 清单 10-10 中 的 解决 方式 如 何 呢 ? 代码 清 
单 10-9 中 Sgl 类 的 每 个 接口 方法 都 重 构 到 从 Sgl 类 派 
生出 来 的 类 中 了 。 注 意 那 些 私 有 方法 ， 如 
valuesList， 直 接 移 到 了 需要 用 它们 的 地 方 。 公 共 私 
有 行为 被 划分 到 独立 的 两 个 工具 类 Where 和 
ColumnList 中 。 

















代码 清单 10-10 一 组 封闭 类 





abstract public class Sql { 
public Sql(String table, Column[] columns) 
abstract public String generate(); 


J 


public class CreateSql extends Sql { 
public CreateSql(String table, Column[] columns) 
QOverride public String generate() 


j 


public class SelectSql extends Sql { 
public SelectSql(String table, Column[] columns) 
QOverride public String generate() 


j 


public class InsertSql extends Sql ( 

public InsertSgl(String table, Column[] columns, Object[] fiel 
ds) 

QOverride public String generate() 

private String valuesList(Object[] fields, final Column[] colu 
mns) 


j 


public class SelectWithCriteriaSql extends Sql { 
public SelectwithCriteriaSql( 
String table, Column[] columns, Criteria criteria) 
QOverride public String generate() 


j 


public class SelectWithMatchSql extends Sql { 
public SelectwithMatchSql( 
String table, Column[] columns, Column column, String patt 
ern) 
QOverride public String generate() 


j 


public class FindByKeySql extends Sql{ 
public FindByKeySql ( 
String table, Column[] columns, String keyColumn, String k 
eyValue ) 
@Override public String generate() 


j 


public class PreparedInsertSql extends Sql ( 
public PreparedInsertSql(String table, Column[] columns) 
@Override public String generate(){ 
private String placeholderList(Column[] columns) 


j 


public class Where { 
public Where(String criteria) 
public String generate() 


} 

public class ColumnList ( 
public ColumnList(Column[] columns) 
public String generate() 








每 个 关中 的 代码 都 变 得 极为 简单 。 理 解 每 个 类 
化 费 的 时 间 绚 减 到 近乎 为 零 。 函 数 对 其 他 函数 造成 
蝶 坏 的 风险 也 变 得 几 近 于 无 。 从 测试 的 角度 看 ， 验 








证 方案 中 每 一 处 馆 辑 都 成 了 极为 简单 的 任务 ， 因 为 
类 与 类 之 间 相 互 隅 离 了 。 


当 需 要 增加 update 语 句 时 ， 现 存 类 无 需 做 任何 
修改 ， 这 也 同等 重要 ! 我 们 在 Sql 类 的 新 子 类 
UpdateSql 中 构建 update 语 句 的 逻辑 。 系 统 中 的 其 他 
代码 都 不 会 因为 这 个 修改 而 被 破坏 。 
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SRP。 它 也 支持 其 他 面 同 对 象 设计 的 关键 原则 ， 如 
开放 -闭合 原则 (OCP) Ul. 类 应 当 对 扩展 开放 ， 











对 修改 封闭 。 通 过 了 于 类 化 手段 ， 重 新 架构 的 Sql 次 
对 添加 新 功能 是 开放 的 ， 而 且 可 以 同时 不 触及 其 他 
类 。 只 要 将 UpdateSql 类 放置 到 位 就 行 了 。 


我 们 希望 将 系统 打造 成 在 湛 加 或 修改 特性 时 尽 
可 能 少 惹 研 烦 的 架子 。 在 理想 系统 中 ， 我 们 通过 扩 
展 系统 而 非 修改 现 有 代码 来 添加 新 特性 。 


隔离 修改 


需求 会 改变 ， 所 以 代码 也 会 改变 。 在 OO 101 
中 中， 我 们 学 习 到 ， 有 具体 类 包含 实现 细节 CR 
£3) ， 而 抽象 类 则 只 呈现 概念 。 依 赖 于 具体 细节 的 
客户 类 ， 当 细节 改变 时 ， 就 会 有 风险 。 我 们 可 以 借 
助 接 口 和 抽象 类 来 隔离 这 些 细节 带 来 的 影响 。 


对 具体 细节 的 依赖 给 对 系统 的 测试 市 来 了 挑 
战 。 如 果 我 们 构建 一 个 依赖 于 外 部 
TokyoStockExchange API 的 Portfolio 类 ， 代 表 投 资 组 
合 的 价值 ， 则 测试 用 例 就 会 受到 价值 得 询 的 连带 影 
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与 其 设计 直接 依赖 于 TokyoStockExchange 的 
Portfolio 类 ， 不 如 创建 StockExchange 接 口 ， 其 中 内 
声明 一 个 方法 : 


public interface StockExchange { 
Money currentPrice(String symbol); 


j 








我 们 设计 TokyoStockExchange 类 来 实现 这 个 接 
口 。 我 们 还 要 确保 Portfolio 的 构造 器 接受 作为 参数 
HJStockExchange 7| Hl: 


public Portfolio { 
private StockExchange exchange; 
public Portfolio(StockExchange exchange) { 
this.exchange = exchange; 


j 
// 
} 





现在 就 可 以 为 StockExchange 接 口 创 建 可 测试 的 
壬 试 性 实现 了 。 访 尝试 性 实现 将 返回 固定 的 现 值 。 
如 采 测 试 中 购买 了 5 股 微软 股票 ， 则 符 试 性 实现 总 
是 返回 每 股 100 美 元 的 现 值 。 对 于 StockExchange 接 
口 的 答 试 性 实现 价 化 为 简单 的 表格 奉 找 。 然 后 再 编 
写 一 个 总 投资 价值 为 500 美 元 的 测试 。 














public class PortfolioTest { 

private FixedStockExchangeStub exchange; 

private Portfolio portfolio; 

QBefore 

protected void setUp() throws Exception { 
exchange = new FixedStockExchangeStub(); 
exchange.fix("MSFT", 100); 
portfolio - new Portfolio(exchange); 


QTest 

public void GivenFiveMSFTTotalShouldBe500() throws Exception { 
portfolio.add(5, "MSFT"); 
Assert.assertEquals(500, portfolio.value()); 





如 果 系 统 解 看 到 足以 这 样 测试 的 程度 ， 也 就 更 











加 灵活 ， 更 加 可 复 用 。 部 件 之 间 的 解 古代 表 着 系统 
中 的 元 素 互相 隅 离 得 很 好 。 隔 离 也 让 对 系统 每 个 元 
素 的 理解 变 得 更 加 容易 。 
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设计 原则 ， 依 赖 倒置 原则 (Dependency Inversion 
Principle, DIP) [S| 。 本 质 而 言 ，DIP 认 为 类 应 当 
依赖 于 抽象 而 不 是 依赖 于 具体 细节 。 


我 们 的 Portfolio 类 不 再 依赖 于 
TokyoStockExchange 类 的 实现 细节 ， 而 是 依赖 于 
StockExchange 接 口 。StockExchange 接 口 呈 现 的 是 
有 天 询问 茶 只 股票 价格 的 抽象 概念 。 这 种 抽象 隅 离 
ILLI 的 特定 细节 ， 包 括 价 格 数 据 来 目 何 处 之 
FR o 
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难以 规划 、 构 建 和 测试 。” 





Ray Ozzie， 人 微软 公司 首席 技术 官 


11.1 如 何 建造 一 个 城市 


PiE CXE Iu? 大 概 人 不行。 即便 是 
管理 一 个 既 存 的 城市 ， 也 是 一 个 人 无 法 做 到 的 。 不 
过 ， 城 市 还 是 在 运转 《多 数 时 候 ) 。 因 为 每 个 城市 
都 有 一 组 组 人 管理 不 同 的 部 分 ， 供 水 系统 、 供 电 系 
统 、 交 通 、 执 法 、 立 法 ， 诸 如 此 类 。 有 些 人 负责 全 
局 MB AA v. 


城市 能 运转 ， 还 因为 它 演化 出 恰当 的 抽象 等 级 
和 模块 ， 好 让 个 人 和 他 们 所 党 理 的 “组 件 ”* 即 便 在 不 
了 解 全 局 时 也 能 有 效 地 运转 。 


尽 过 软件 团队 往往 也 是 这 样 组 织 起 来 ， 但 他 们 
所 致力 的 工作 却 第 种 没有 同样 的 关注 面 切 分 及 抽象 
层级 。 整 洁 的 代码 帮助 我 们 在 较 低 层 的 抽象 技 级 上 
达成 这 一 目标 。 本 重 将 讨论 如 何在 较 高 的 抽象 层级 
系统 层级 一 一 上 保持 整洁 。 























11.2 将 系统 的 构造 与 使 用 分 开 


Hc. Mit 与 使 用 古 非 党 不 一 样 的 过 程 。 当 
我 走笔 至 此 ， 投 目 窗外 的 芝加哥 ， 看 到 有 一 间 酒 店 
正在 建设 。 今 天 ， 那 只 是 个 框架 结构 ， 起 重 机 和 升 
BNL IN A ESP TED © TRE At ERR, ARZ 
全 帽 。 大 概 一 年 之 后 ， 酒 店 就 将 建成 。 起 重 机 和 升 
降 机 者 会 消失 无 踪 。 建 筑 物 变 得 整洁 ， 和 罗兰 痢 玻 璃 
T Meso. ERR TEREA, AA 
到 完全 不 同 的 景象 。 


软件 系统 应 将 局 始 过 程 和 局 始 过 程 之 后 的 运行 
时 迄 辑 分 离开 ， 在 局 始 过 程 中 构建 应 用 对 象 ， 也 会 
存在 互相 缠 结 的 依赖 关系 。 


每 个 应 用 程序 都 该 留意 局 始 过 程 。 那 也 是 本 
革 中 我 们 首先 要 考虑 的 问题 。 将 关注 的 方面 分 离 
开 ， 是 软件 技艺 中 最 古老 也 最 重要 的 设计 技巧 。 


不 焉 的 是 ， 多 数 应 用 程序 部 没有 做 分 离 处 理 。 
司 始 过 程 代 码 很 特殊 ， 被 混杂 到 运行 时 迎 辑 中 。 下 
例 束 是 典型 的 情形 : 














public Service getService() { 
if (service -- null 
service - new MyServiceImpl(...); // Good enough default fo 


r most cases? 
return service; 


j 


XX Le Pria. ， 也 有 一 些 好 
处 。 在 真正 用 到 对 象 之 前 ， 无 需 操心 这 种 架空 构 
造 ， 司 始 时 间 也 会 更 得， 而且 还 能 保证 永远 不 会 返 
四 null 值 。 


然而 ， 我 们 也 得 到 了 MyServiceImpl 及 其 构造 
妖 所 圭一 切 ( 我 省 略 了 那些 代码 〉 的 便 编码 依赖 。 
不 分 解 这 些 依赖 关系 就 无 法 编译 ， 即 便 在 运行 时 永 
不 使 用 这 种 类 型 的 对 象 ! 


如 果 MyServiceImpl 是 个 重型 对 象 ， 则 测试 也 
会 是 个 问题 。 我 们 必须 确保 在 单元 测试 调用 该 方法 
ZH, HLZaservice 指派 恰当 的 测试 将 身 CTEST 
DOUBLE) |! 或 仿制 对 象 (MOCK OBJECT) 。 
由 于 构造 逻辑 与 运行 过 程 相 混 林 ， 我 们 必须 测试 所 
有 的 执行 路 径 〈 例 如 ，null 值 测试 及 其 代码 块 ) 。 
A RHE at, ARTA SN LES, ORE 
略微 违反 了 单一 权 责 原则 。 

最 糟 料 的 大 概 是 我 们 不 知道 MyServiceImpl 在 


所 有 情形 中 是 舍 部 是 正确 的 对 象 。 我 在 代码 注释 中 
做 了 上 暗示。 为 什么 该 方法 所 属 类 必须 知道 全 局 情 











A? 我 们 是 售 真 能 知道 在 这 里 要 用 到 的 正确 对 象 ? 
征 售 具有 可 能 存在 一 种 放 之 四 海 而 音准 的 类 型 ? 


当然 ， 仅 出 现 一 次 的 延迟 初始 化 不 算是 严重 问 
题 。 不 过 ， 在 应 用 程序 中 往往 有 许多 种 类 似 的 情况 
出 现 。 于 是 ， 全 局 设置 策略 (如 果 有 的 话 ) 在 应 
用 程序 中 四 散 分 布 ， 缺 乏 模 块 组 织 性 ， 通 第 也 会 
AVES HZ VAS 


BORE ETT ta GE BS UE BL or Dd FE AR 
统 ， 束 不 该 让 这 类 就 手 小 技巧 破坏 模块 组 织 性 。 
对 象 构造 的 局 始 和 设置 过 程 也 不 例外 。 应 当 将 这 个 
过 程 从 正 第 的 运行 时 逻辑 中 分 离 出 来 ， 确 你 拥有 人 解 
决 主要 依赖 问题 的 全 局 性 一 员 束 上 略 。 























11.2.1 分 解 main 


将 构造 与 使 用 分 开 的 方法 之 一 是 将 全 部 构造 过 

程 搬迁 到 main 或 被 称 之 为 main 的 模块 中 ， 设 计 系 统 

的 其 余部 分 时 ， 假 设 所 有 对 象 都 已 正确 构造 和 设置 
(如 图 11-1 所 示 )。 








co:Configured 
Object 





图 11-1 将 构造 分 解 到 main( ) 中 


控制 流程 很 容易 理解 。main 函 数 创 建 系 统 所 需 
的 对 象 ， 再 传递 给 应 用 程序 ， 应 用 程序 只 管 使 用 。 
注意 看 横贯 main 与 应 用 程序 之 间隔 党 的 依赖 箭头 的 
方向 。 它 们 都 从 main 函 数 问 外 走 。 这 表示 应 用 程序 
对 main 或 者 构造 过 程 一 无 所 知 。 它 只 是 简单 地 指望 
一 切 已 齐备 。 


11.2.2 工厂 


当然 ， 有 时 应 用 程序 也 要 负责 确定 何 时 创建 
对 象 。 比 如 ， 在 某 个 订单 处 理 系统 中 ， 应 用 程序 必 
须 创 建 LineItem 实 体 ， 添 加 到 Order 对 象 。 在 这 种 情 
况 下 ， 我 们 可 以 使 用 抽象 工厂 模式 UP 让 应 用 自行 














控制 何 时 创建 LineItems， 但 构造 的 细节 却 隔离 于 应 
用 程序 代码 之 外 。 













run (facto 
- ty) OrderProcessing 


<<creates>> 






<<interiace>> 
LineltemFactory 






LineltemFactory 
Implementation 







[^ 


*makeLineltem 


d 





<<creates>> 


图 11-2 ”使 用 工厂 分 离 构造 过 程 


再 留意 一 下 ， 所 有 依赖 都 是 从 main 指 癌 
OrderProcessing 应 用 程序 。 这 代表 应 用 程序 与 如 何 
构建 LineIltem 的 细节 是 分 离开 来 的 。 构 建 能 力 由 
LineItemFactoryImplementation 持 有 ， 而 
LineItemFactoryImplementation 又 是 在 main 这 一 边 
的 。 但 应 用 程序 能 完全 控制 LineItem 实 体 何 时 构 
建 ， 甚 全 能 传递 应 用 特定 的 构造 器 参数 。 


11.2.3 ”依赖 注入 
有 一 种 强大 的 机 制 可 以 实现 分 离 构 造 与 使 用 ， 


那 束 是 依赖 注入 (Dependency Injection, DD ， 控 
制 反 转 (Inversion of Control, IoC) 在 依赖 管理 中 











的 一 种 应 用 手段 9 。 控 制 反 转 将 第 二 权 责 从 对 象 
中 拿 出 来 ， 转 移 到 另 一 个 专注 于 此 的 对 象 中 ， 从 而 
遵循 了 单一 权 责 原则 。 在 依赖 管理 情景 中 ， 对 象 
不 应 负责 实体 化 对 目 喘 的 依赖 。 反 之 ， 它 应 当 将 这 
份 权 员 移 交 给 其 他 “有 权力 ”的 机 制 ， 从 而 实现 控制 
的 反 转 。 因 为 初始 设置 是 一 种 全 局 问题 ， 这 种 授权 
机 制 通 和 常 要 么 是 main 例 程 ， 要 么 是 有 特定 目的 的 容 
A 








JNDI 查 找 是 DI 的 一 种 “部 分 ”实现 。 在 JNDI 
中 ， 对 象 请 求 日 录 服 务 器 提供 一 种 符合 某 个 特定 名 
称 的 “服务 ”。 





MyService myService = (MyService)(jndiContext.lookup("NameOfMyS 
ervice")); 





调用 对 象 并 不 控制 真正 返回 对 象 的 类 别 〈 当 然 
六 提 是 它 实现 了 恰当 的 接口 ) ， 但 调用 对 象 仍然 主 
动 分 解 了 依赖 。 


真正 的 依赖 注入 还 要 更 进一步 。 类 并 不 直接 分 
解 其 依赖 ， 而 是 完全 被动 的 。 它 提供 可 用 于 注入 
依赖 的 赋值 带 方 法 或 构造 右 参 数 (或 二 者 省 有 ) 。 
在 构造 过 程 中 ，DI 容 右 实 体 化 需要 的 对 象 〈 通 第 按 
需 创 建 )， 并 使 用 构造 器 参数 或 赋值 器 方法 将 依赖 











连接 到 一 起 。 人 至 于 哪个 依赖 对 象 真正 得 到 使 用 ， 是 
通过 配置 文件 或 在 一 个 有 特殊 目的 的 构造 模块 中 编 
程 决定 。 


Spring 框架 提供 了 最 有 名 的 Java DI 容器 ^1, H 
户 在 XML 配置 文件 中 定义 互相 关联 的 对 象 ， 然 后 用 
Java 代 码 请 求 特定 的 对 象 。 稍 后 我 们 束 会 看 到 例 
Eu 


但 延 后 初始 化 的 好 处 是 什么 呢 ? 这 种 手段 在 DI 
中 也 有 其 作用 。 痛 先 ， 多 数 DI 容 堪 在 需要 对 象 之 前 
并 不 构造 对 象 。 其 次 ， 许 多 这 关 容 融 提 供 调用 工矿 
或 构造 代理 的 机 制 ， 而 这 种 机 制 可 为 延迟 赋值 或 类 
似 的 优化 处 理 所 用 O3 。 

















11.3 扩容 


城市 由 城镇 而 来 ， 城 镇 由 聚居 而 来 。 一 开始 ， 
道路 狭 罕 ， 几 乎 无 人 涉足 ， 随 后 逐渐 拓宽 。 小 型 建 
抠 和 空地 渐渐 被 更 大 的 建筑 所 取代 ， 一 些 地 方 最 终 
A E EA XR. 


一 开始 ， 供 电 、 供 水 、 下 水 、 互 联网 CHE!) 
等 服务 全 部 欠 奉 。 随 着 人 口 和 建筑 密度 的 增加 ， 这 
些 服 务 也 开始 出 现 。 


这 种 成 长 并 非 全 无 阵痛 。 你 有 多 少 次 开 着 车 ， 
艰难 穿行 过 一 个 “道路 改善 ”工程 ， 问 自己,“ 他们 
为 什么 不 一 开始 就 修 条 够 党 的 路 呢 ?! ” 


不 过 那 无 论 如 何不 可 能 实现 。 谁 敢 打 包 守 说 在 
一 个 小 镇 修建 一 条 六 和 车道 的 公路 并 不 浪费 呢 ? 谁 会 
想 要 这 么 一 条 和 穿 过 他 们 小 镇 的 路 呢 ? 


“一 开始 束 做 对 系统 ” 纯 属 神 话 。 有 反之， 我 们 应 
该 只 去 实现 今天 的 用 尸 故事 ， 然 后 重 构 ， 明 天 再 
扩展 系统 、 实 现 新 的 用 户 故 事 。 这 束 是 达 代 和 增 量 
敏捷 的 精 艇 所在。 训 斌 驱动 开发 、 重 构 以 及 它们 打 
造 出 的 整洁 代码 ， 在 代码 层面 保证 了 这 个 过 程 的 实 
现 。 

















import javax.ejb.*; 


复杂 ， I 6 


但 在 系统 层面 又 如 何 ? MEE IS SAR AS 页 
先 做 好 计划 吗 ? 系统 理所当然 不 可 能 从 简单 递增 到 
已 能 行 吗 ? 


us ee Ti 


与 物理 系统 相 比 软件 系统 比较 独特 。 它 们 的 架 
构 都 可 以 递增 式 地 增长 ， 只 要 我 们 持续 将 关注 面 恰 
当地 切 分 。 


如 我 们 将 见 到 的 那样 ， 软 件 系 统 短 生 命 周期 本 
质 使 这 一 切 变 得 可 行 。 我 们 驳 来 看 一 个 没有 充分 隅 
离 天 注 问 题 的 架构 反例 。 





初始 的 EJB1 和 EJB2 架 构 没 有 恰当 地 切 分 关注 
面 ， 从 而 给 有 机 增长 压 上 了 不 必要 的 负担 。 比 如 一 


个 持久 Bank 类 的 Entity Bean. Entity bean 是 关系 数 
据 在 内 存 中 的 体现 ， 换 言 之 ， 是 表格 的 一 行 





自 完 ， 你 要 定义 一 个 本 地 (进程 内 ) 或 远程 


(分 离 的 JVM) 接口 ， 供 客户 代码 使 用 。 代 码 消 单 
11-1 束 是 一 种 可 能 的 本 地 接口 : 


代码 清单 11-1 Bank EJB 的 EJB2 本 地 接口 
package com.example.banking; 


import java.util.Collections; 





public interface BankLocal extends java.ejb.EJBLocalObject ( 
String getStreetAddri() throws EJBException; 


String getStreetAddr2() throws EJBException; 


String getCity() throws EJBException; 

String getState() throws EJBException; 

String getZipCode() throws EJBException; 

void setStreetAddri(String street1) throws EJBException; 
void setStreetAddr2(String street2) throws EJBException; 
void setCity(String city) throws EJBException; 

void setState(String state) throws EJBException; 

void setZipCode(String zip) throws EJBException; 
Collection getAccounts() throws EJBException; 

void setAccounts(Collection accounts) throws EJBException; 
void addAccount(AccountDTO accountDTO) throws EJBException; 





上 面 列 出 了 银行 地 址 的 几 个 属性 ， 和 一 组 该 银 





行 拥有 的 账户 ， 其 中 每 个 账户 的 数据 都 由 单独 的 
Account EJB 所 持 有 。 代 人 码 清 单 11-2 展 示 J Bank 
bean 的 相应 实现 类 。 


代码 清单 11-2 ”相应 的 EJB2 Entity Bean 实 现 





package com.example.banking; 
import java.util.Collections; 
import javax.ejb.*; 


public abstract class Bank implements javax.ejb.EntityBean { 
// 业务 逻辑 ... 
public abstract String getStreetAddr1(); 
public abstract String getStreetAddr2(); 
public abstract String getCity(); 
public abstract String getState(); 
public abstract String getZipCode(); 
public abstract void setStreetAddri(String street1); 
public abstract void setStreetAddr2(String street2); 
public abstract void setCity(String city); 
public abstract void setState(String state); 
public abstract void setZipCode(String zip); 
public abstract Collection getAccounts(); 
public abstract void setAccounts(Collection accounts); 














public void addAccount(AccountDTO accountDTO) ( 
InitialContext context - new InitialContext(); 
AccountHomeLocal accountHome = context.lookup("AccountHomeLo 
cal"); 
AccountLocal account = accountHome.create(accountDTO); 
Collection accounts - getAccounts(); 
accounts.add(account); 


// EJB container logic 

public abstract void setId(Integer id); 

public abstract Integer getId(); 

public Integer ejbCreate(Integer id) { ... } 
public void ejbPostCreate(Integer id) { ... } 

// The rest had to be implemented but were usually empty: 
public void setEntityContext(EntityContext ctx) {} 
public void unsetEntityContext() {} 

public void ejbActivate() {} 

public void ejbPassivate() {} 

public void ejbLoad() {} 

public void ejbStore() {} 

public void ejbRemove() {} 





我 没有 列 出 对 应 的 LocalHome 接 口 ， 访 接口 基 





本 上 是 用 来 创建 对 象 的 ， 也 没有 列 出 你 可 能 添加 的 
Bank tas (CEW) 。 


最 后 ， 你 要 编写 一 个 或 多 个 XML 部 署 说 明 ， 将 
对 象 相 关 映 射 细 节 指 定 给 某 个 持久 化 存储 空间 ， 说 
明 期 望 的 事物 行为 、 安 全 约束 等 。 


Ap 2522 38 5 EJB2 NE HU" EEG Ere VID DI 
TORQUE aR, AGERE BS MAE ais PIT ra BEAN 
生命 周期 方法 。 





由 于 存在 这 种 与 重量 级 容 露 的 紧 耘 合 ， 陋 离 单 
元 测试 就 很 困难 。 有 必要 模拟 出 容器 (这 很 难 〉， 
或 者 花费 大 量 时 间 在 真实 服务 器 上 部 著 EJB 和 测 
试 。 也 由 于 耦合 的 存在 ， 在 EJB2 架 构 之 外 的 复 用 实 
际 上 变 得 不 可 能 。 


最 终 ， 连 面 癌 对 象 编程 本 有 身 也 被 侵蚀 。bean 不 
能 继承 上 自 另 一 个 bean。 留 意 这 加 新 账 豆 的 逻辑 。 在 
EJB2 bean 中 ， 定 义 一 种 本 质 上 是 无 行为 struct 的 “ 数 
据 传 输 对 象 ”(DTO) 很 常见 。 这 往往 会 导致 拥有 
同样 数据 的 见 余 类 型 出 现 ， 而 且 也 需要 在 对 象 之 间 
复制 数据 的 八股 式 代 人 码 。 


pe bi SORE 


在 某 些 领域 ，EBJ2 架 构 已 经 很 接近 于 真正 的 天 
注 面 切 人 分。 例如， 在 与 源 代 码 分 离 的 部 署 摘 述 中 声 
明了 期 待 的 事务 、 安 全 及 部 分 持久 化 行为 。 


注意 ， 持 久 化 之 类 关注 面 BRIT ER A PAH 
域 的 天 然 对 象 边 界 。 你 会 想 用 同样 的 策略 来 持久 化 
所 有 对 象 ， 例 如 ， 使 用 DBMS 9! 而 非 平面 文件 ， 
表 名 和 列 名 遵循 人 种 命名 约定 ， 采 用 一 致 的 事务 语 


义 ， 等 等 。 


原则 上 ， 你 可 以 从 模块 、 封 竣 的 角度 推理 持久 























化 策略 。 但 在 实践 上 ， 你 却 不 得 不 将 实现 了 持久 化 
束 略 的 代码 铺展 到 许多 对 象 中 。 我 们 用 术语 “ 模 贡 
AREN ”来 形容 这 类 情况 。 同 样 ， 持 久 化 框架 和 
领域 馆 辑 ， 孤 立地 看 也 可 以 是 模块 化 的 。 问 题 在 于 
横贯 这 些 领域 的 情形 。 


实际 上 ，EJB 架 构 处 理 持久 化 、 安 全 和 事务 的 
方法 要 早 于 面 同方 面 编程 (aspect-oriented 
programming, AOP) U!, ， 而 AOP 是 一 种 恢复 横贯 
式 关 注 面 模块 化 的 普 适 手段 。 


在 AOP 中 ， 被 称 为 方面 Caspect) 的 模块 构造 
指明 了 系统 中 哪些 点 的 行为 会 以 菏 种 一 致 的 方式 被 
修改 ， 从 而 支持 某 种 特定 的 场景 。 这 种 说 明 是 用 茶 
种 简洁 的 声明 或 编程 机 制 来 实现 的 。 


以 持久 化 为 例 ， 可 以 声明 哪些 对 象 和 属性 或 
其 模式 ) 应 当 被 持久 化 ， 然 后 将 持久 化 任务 委托 给 
持久 化 框架 。 行 为 的 修改 由 AOP 框 架 以 无 损 方式 19] 
在 目标 代码 中 进行 。 下 面 来 看 看 Java 中 的 三 种 方面 
或 类 似 方面 的 机 制 。 











11.4 Java 代理 


Java 代 理 适 用 于 简单 的 情况 ， 例 如 在 单独 的 对 
象 或 类 中 包装 方法 调用 。 人 然而 ，JDK 提 供 的 动态 代 
理 仅 能 与 接口 协同 工作 。 对 于 代理 类 ， 你 得 使 用 字 
节 码 操作 库 ， 比 如 CGLIB、ASM 或 Javassist ?! 。 


代码 清单 11-3 展 示 了 为 我 们 的 Bank 应 用 程序 所 
供 持久 化 支持 的 JDK 人 代理， 代码 仅 履 新 设置 和 取得 
账号 列表 的 方法 。 











代码 清单 11-3 ”JDK 代理 范例 





// Bank.java (suppressing package names...) 
import java.utils.*; 


// The abstraction of a bank. 
public interface Bank { 
Collection<Account> getAccounts(); 
void setAccounts(Collection<Account> accounts); 


j 


// BankImpl.java 
import java.utils.*; 


// The "Plain Old Java Object" (POJO) implementing the abstract 
ion. 
public class BankImpl implements Bank { 

private List«Account» accounts; 


public Collection<Account> getAccounts() { 
return accounts; 


public void setAccounts(Collection<Account> accounts) { 
this.accounts = new ArrayList«Account»(); 
for (Account account: accounts) { 
this.accounts.add(account); 


j 
j 
j 


// BankProxyHandler. java 
import java.lang.reflect.*; 
import java.util.*; 


// "InvocationHandler" required by the proxy API. 
public class BankProxyHandler implements InvocationHandler ( 
private Bank bank; 


public BankHandler (Bank bank) ( 
this.bank - bank; 


j 


// Method defined in InvocationHandler 
public Object invoke(Object proxy, Method method, Object[] arg 
S) 

throws Throwable ( 

String methodName - method.getName(); 

if (methodName.equals("getAccounts")) { 
bank.setAccounts(getAccountsFromDatabase()); 
return bank.getAccounts(); 

} else if (methodName.equals("setAccounts")) { 
bank.setAccounts((Collection<Account>) args[0]); 
setAccountsToDatabase(bank.getAccounts()); 
return null; 

) else { 


je 


} 
// Lots of details here: 


protected Collection<Account> getAccountsFromDatabase() { ... 


J 


protected void setAccountsToDatabase(Collection<Account> accou 


nts) f ... 4 
} 


// Somewhere else... 


Bank bank = (Bank) Proxy.newProxyInstance( 
Bank.class.getClassLoader(), 
new Class[] { Bank.class }, 
new BankProxyHandler(new BankImpl())); 





我 们 定义 了 将 被 代理 包装 起 来 的 接口 Bank， 
还 有 旧式 的 Java 对 象 〈(Plain-Old Java Object, 
POJO) BankImpl， 该 对 象 实现 业务 逻辑 〈 稍 后 再 
来 看 POJO) 。 


Proxy API 需 要 一 个 InvocationHandler 对 象 ， 用 
来 实现 对 代理 的 全 部 Bank 方 法 调用 。 
BankProxyHandler 使 用 Java 反 射 API 将 一 般 方法 调用 
英 射 到 BankImpl 中 的 对 应 方法 ， 以 此 类 推 。 








即便 对 于 这 样 简单 的 例子 ， 也 有 许多 相对 复杂 
的 代码 [10] 。 使 用 那些 字 节 操作 类 库 也 同样 具有 挑 
战 性 。 代 码 量 和 复杂 度 是 代理 的 两 大 弱点 ， 创 建 束 
洁 代 码 变 得 很 难 ! 另外 ， 代 理 也 没有 提供 在 系统 范 
围 内 指定 执行 点 的 机 制 ， 而 那 正 是 真正 的 AOP 解 决 
方案 所 必须 的 0， 








11.5 ZliJava AOPHE 2 


对 运 的 是 ， 编 程 工具 能 目 动 处 理 大 多 数 代理 模 
板 代码 。 在 数 个 Java 框 架 中 ， 代 理 都 是 内 舱 的 ， 如 
Spring AOP 和 JBoss AOP 等 ， 从 而 能 够 以 纯 Java 代 码 
实现 面向 方面 编程 2 。 在 Spring 中 ， 你 将 业务 逻 
辑 编码 为 旧式 Java 对 象 。POJO 目 扫 门 前 雪 ， 并 不 
依赖 于 企业 框架 (或 其 他 域 。 因 此 ， 它 在 概念 上 
更 简单 、 更 易于 测试 驱动 。 相 对 简单 性 也 较 易 于 保 
证 正确 地 实现 相应 的 用 户 故 事 ， 并 为 未 来 的 用 户 故 
事 维 护 和 改进 代码 。 


使 用 描述 性 配置 文件 或 API， 你 把 需要 的 应 用 
程序 构架 组 合 起 来 ， 包 括 持 久 化 、 事 务 、 安 全 、 绥 
人 存 、 恢 复 等 横贯 性 问题 。 在 许多 情况 下 ， 你 实际 上 
只 是 指定 Spring 或 Jboss 类 库 ， 框 架 以 对 用 户 透 明 的 
方式 处 理 使 用 Java 代 理 或 字 节 代码 库 的 机 制 。 这 些 
声明 驱动 了 依赖 注入 CODD 容器 ，DI 容 器 再 实体 化 
主要 对 象 ， 并 按 需 将 对 象 连接 起 来 。 


代码 清单 11-4 展 示 了 Spring V2.5 配 置 文件 
app.xml 的 典型 片段 [13] 。 


代码 清单 11-4 Spring 2.x 的 配置 文件 




















<beans> 


«bean id="appDataSource" 
class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:driverClassName="com.mysql.jdbc.Driver" 
p:url="jdbc:mysql://localhost :3306/mydb" 
p:username="me"/> 


<bean id="bankDataAccessObject" 
class="com.example.banking.persistence.BankDataAccessObject" 
p:dataSource-ref="appDataSource"/> 


<bean id="bank" 
class="com.example.banking.model.Bank" 
p:dataAccessObject -ref="bankDataAccessObject"/> 


</beans> 





fi^ bean Re REARS EE” A, 
每 个 由 数据 存 取 器 对 象 (DAO) 代理 (包装 ) 的 
Bank 都 有 个 域 对 象 ， 而 bean 本 里 义 是 由 JDBC 了 驱动 
程序 数据 源 代理 (如 图 11-3 所 示 ) 。 





AppDataSource 







BankDataAcessObject 





客户 代码 





图 11-3 “俄罗斯 套 娃 ” 式 的 油漆 工 模 式 





客户 代码 以 为 调用 的 是 Bank 对 和 象 的 getAccount( 
) 方 法 ， 其 实 它 是 在 与 一 组 扩展 Bank POJO 基 础 行为 
的 油漆 工 (DECORATOR) U4 对 象 中 最 外 面 的 那 
个 沟通 。 


在 应 用 程序 中 ， 只 添加 了 少数 几 行 代码 ， 用 来 
癌 DI 容 需 请 求 系统 中 的 顶层 对 象 ， 如 XML 文件 中 所 
定义 的 那样 。 








XmlBeanFactory bf = 
new XmlBeanFactory(new ClassPathResource("app.xml", getClass 


02); 


Bank bank = (Bank) bf.getBean("bank"); 





只 有 区 区 几 行 与 Spring 相关 的 Java 人 代码， 应 用 
程序 几乎 完全 与 Spring 分 离 ， 消 除了 EJB2 之 关系 统 
FF IURE tr nd jell e 


尽管 XML 可 能 会 元 长 且 难 以 阅读 51, mum 
件 中 定义 的 “策略 ”还 是 要 比 那 种 隐藏 在 幕后 目 动 创 
建 的 复杂 的 代理 和 方面 逻辑 来 得 简单 。 这 种 类 型 的 
架构 是 如 此 引 人 注 目 ，Spring 之 类 的 框架 最 终 导致 
了 EJB 标 准 在 第 3 版 的 彻底 变化 。 使 用 XML 配 置 文 
件 和 /或 Java 5 annotation，EJB3 很 大 程度 上 遵循 了 
Spring 通过 摘 述 性 手段 文 持 横贯 式 关 注 面 的 模型 。 

















代码 清单 11-5 展 示 了 用 EJB3 重 写 的 Bank 对 象 


[16] | 


ACAI 811-5 ”EJB3 版 本 的 Bank 





package com.example.banking.model; 
import javax.persistence.*"; 

import java.util.ArrayList; 

import java.util.Collection; 


QEntity 
QTable(name = "BANKS") 
public class Bank implements java.io.Serializable { 
QId QGeneratedValue(strategy-GenerationType.AUTO) 
private int id; 
QEmbeddable // An object "inlined" in Bank's DB row 
public class Address ( 
protected String streetAddri; 
protected String streetAddr2; 
protected String city; 
protected String state; 
protected String zipCode; 


j 


QEmbedded 
private Address address; 


QOneToMany(cascade - CascadeType.ALL, fetch - FetchType.EAGER, 


mappedBy="bank" ) 
private Collection<Account> accounts = new ArrayList<Account>( 


); 


public int getId() { 
return id; 


} 

public void setId(int id) { 
this.id - id; 

} 


public void addAccount(Account account) { 


account.setBank(this); 
accounts.add(account); 


public Collection<Account> getAccounts() { 
return accounts; 


public void setAccounts(Collection<Account> accounts) { 
this.accounts = accounts; 





上 列 代 码 要 比 原本 的 EJB2 代 码 整洁 多 了 。 有 些 
实体 细节 仍然 在 annotation 中 存在 。 不 过 ， 因 为 没有 
任何 信息 超出 annotation 之 外 ， 代 码 依然 整洁 、 清 





晰 ， 也 因此 而 易于 测试 驱动 、 吻 于 维护 。 


如 果 愿 意 的 话 ，annotation 中 有 些 或 全 部 持久 化 
言 恩 可 以 转移 到 XML 部 署 描述 中 ， 只 留 下 真正 的 纯 
POJO。 如 果 持 久 化 映射 细节 不 会 频 党 改动， 许多 
团队 可 能 会 选择 保留 annotation， 但 与 EJB2 那 种 侵 
害 性 相 比 还 是 少 了 很 多 问题 。 





11.6 AspectJ 的 方面 


通过 方面 来 实现 关注 面 切 分 的 功能 最 全 的 工具 
是 AspectJ 语 言 上 ， 一 种 提供 “一 流 的 ”将 方面 作为 
模块 构造 处 理 文 持 的 Java 扩 展 。 在 80%6~909% 用 到 方 
面 特性 的 情况 下 ，Spring AOP 和 JBoss AOPHE TEM 
纯 Java 实 现 手段 足够 使 用 。 然 而 ，AspectJ 却 提供 了 
一 套用 以 切 分 关注 耐 的 丰富 而 强 有 力 的 工 其 。 
AspectJ 的 弱势 在 于 ， 需 要 采用 几 种 新 工具 ， 学 习 新 
语言 构造 和 使 用 方式 。 


厌 由 AspectJ 近 期 引入 的 “annotation form" Cfi 
用 Java 5 annotation 定 义 纯 Java 代 码 的 方面 ) ， 新 工 
具有 采用 的 问题 大 大 减少 。 男 外 ，Spring Framework 
也 有 一 些 让 拥有 较 少 AspectJ 经 验 的 团队 更 容易 组 合 
基于 annotation 的 方面 的 特性 。 


关于 AspectJ 的 全 面 探 讨 已 经 超出 本 书 范 围 。 更 
多 信息 可 参见 [AspectJ]、[Colyerj 和 [Spring]。 

















11.7 测试 驱动 系统 架构 


通过 方面 式 的 手段 切 分 关注 面 的 威力 不 可 低 
佑 。 假 使 你 能 用 POJO 编 写 应 用 程序 的 领域 逻辑 ， 
在 代码 层面 与 架构 关注 面 分 离开 ， 就 有 可 能 真正 地 
用 测试 来 驱动 架构 。 采 用 一 些 新 技术 ， 就 能 将 架 
构 按 需 从 简单 演化 到 精细 。 没 必要 先 做 大 设计 
(Big Design Up Front, BDUF) 18] 。 实 际 上 ， 
BDUF 甚 至 是 有 害 的 ， 它 阻碍 改进 ， 因 为 心理 上 会 
抵制 丢弃 既成 之 事 ， 也 因为 架构 上 的 方案 选择 影响 
到 后 续 的 设计 思路 。 


建筑 设计 师 不 得 不 做 BDUF， 因 为 一 旦 建造 过 
程 开 始 ， 就 不 可 能 对 大 型 物理 建筑 的 结构 做 根本 性 
改动 1 。 尽 管 软件 也 有 物理 UO 的 一 面 ， 只 要 软 
件 的 构架 有 效 切 分 了 各 个 关注 面 ， 还 是 有 可 能 做 根 
本 性 改动 的 。 


这 意味 着 我 们 可 以 从 “简单 目 然 ”但 切 分 民 好 的 
架构 开始 做 软件 项 目 ， 快 速 交 付 可 工作 的 用 户 故 
事 ， 随 看 规模 的 增长 添 加 更 多 基础 架构 。 有 些 世 界 
上 最 大 的 网 站 采用 了 精密 的 数据 缓存 、 安 全 、 虚 拟 
化 等 技术 ， 获 得 了 极 高 的 可 用 性 和 性 能 ， 在 每 个 抽 
象 层 和 范围 之 内 ， 那 些 最 小 化 耦合 的 设计 痢 人 简单 到 











位 ， 效 率 和 灵活 性 也 随 之 而 来 。 


当然 ， 这 不 是 说 要 至 无 准备 地 进入 一 个 项 目 。 
对 于 总 的 履 凋 范围 、 目 标 、 项 目 进度 和 最 终 系 统 的 
忆 体 构架 ， 我 们 会 有 所 预期 。 不 过 ， 我 们 必须 有 能 
力 随机 应 变 。 


EJB 早 期 染 构 就 是 一 种 闭 名 的 过 度 工 程 化 而 没 
能 有 效 切 分 关注 面 的 API。 在 没 能 真正 得 到 使 用 
时 ， 设 计 得 再 好 的 API 也 等 于 是 杀 鸡 用 牛刀 。 优 秀 
的 API 在 大 多 数 时间 者 该 在 视线 之 外 ， 这 样 团队 才 
能 将 创造 力 集中 在 要 实现 的 用 户 故 事 上 。 人 人 否则， 以 
构 上 的 约束 束 会 妨碍 同 客 尸 交 付 优化 价值 的 软件 。 


概 言 之 ， 


最 佳 的 系统 架构 由 模块 化 的 关注 面 领域 组 成 ， 
每 个 关注 面 均 用 纯 Java Ck His go xs sc. 
不 同 的 领域 之 间 用 最 不 具有 侵害 性 的 方面 或 类 方面 
工具 整合 起 来 。 这 种 染 构 能 测试 驱动 ， 束 像 代码 一 
样 。 





























11.8 RRR 


RREAK IE TR V] 43 Bah Y D E EAA 
Ro FERWAR, ME Ee — ABST BPE 
项 目 ， 无 人 能 做 所 有 决策 。 


众所周知 ， 最 好 古 授 权 给 最 有 资格 的 人 。 但 我 
AT Ein. WIR RRS aa A 也 是 好 手 
段 。 这 不 是 懒惰 或 不 负责 ; 它 让 我 们 能 够 基于 最 有 
可 能 的 信息 做 出 选择 。 提 前 决 集 是 一 种 预备 知识 不 
AEWA WRIA, BIRD AS PI 
Wu. RPH AYES AS Tit AL o 


拥有 模块 化 关注 面 的 POJO 系 统 提供 的 敏捷 能 
力 ， 人 允许 我 们 基于 最 新 的 知识 做 出 优化 的 、 时 机 刚 
好 的 决策 。 决 策 的 复杂 性 也 降低 了 。 











11.9 明和 镶 使 用 还 加 了 可 论证 价值 
的 标准 


建筑 构造 大 有 可 观 ， 既 因为 新 建筑 的 构建 过 程 
《即便 是 在 隆冬 季节 ) ， 也 因为 那些 现今 科技 所 能 
实现 的 超凡 设计 。 建 筑 业 是 一 个 成 熟 行业 ， 有 着 局 
度 优化 的 部 件 、 方 法 和 和 久 经 岁月 历练 的 标准 。 


即便 是 轻 量 级 和 更 直截了当 的 设计 已 足 甫 使 
用 ， 许 多 团队 还 是 采用 了 EJB2 架 构 ， 只 因为 EJB2 
是 个 标准 。 我 见 过 一 些 团队 ， 纠 缠 于 这 个 或 那个 名 
ERKE 的 标准 ， 却 丧失 了 对 为 客户 实现 价值 的 关 
注 。 














有 了 标准 ， 束 更 易 复 用 想法 和 组 件 、 座 用 拥有 
相关 经 验 的 人 才 、 封 流 好 扣子 ， 以 及 将 组 件 连 接 起 
来 。 不 过 ， 创 立 标 准 的 过 程 有 时 却 漫长 到 行业 等 不 
及 的 程度 ， 有 些 标 准 没 能 与 它 要 服务 的 采用 者 的 真 
实 需 求 相 结合 。 





11.10 系统 需要 领域 特定 语言 


建筑 ， 与 大 多 数 其 他 领域 一 样 ， 发 展 出 一 套 丰 
是 的 语言 ， 有 词汇 、 亢 语 和 清晰 而 简洁 地 表达 基础 
信息 的 句 式 2 。 在 软件 领域 ， 领 域 特定 语言 
(Domain-Specific Language, DSL) P 最 近 重 受 
关注 。DSL 是 一 种 单独 的 小 型 脚本 语言 或 以 标准 语 
填写 就 的 API， 领 域 专家 可 以 用 它 纺 写 读 起 来 像 是 
组 织 严 齐 的 散文 一 般 的 代码 。 


优秀 的 DSL 填 平 了 领域 概念 和 实现 领域 概念 的 
代码 之 间 的 “ 壤 沟 ?， 融 像 敏捷 实践 优化 了 开发 团队 
和 甲 方 之 间 的 沟通 一 样 。 如 条 你 用 与 领域 专家 使 用 
的 同一 种 语言 来 实现 领域 馆 辑 ， 就 会 降低 不 正确 地 
将 领域 翻译 为 实现 的 风险 。 


DSL 在 有 效 使 用 时 能 提升 代码 惯用 法 和 设计 模 
式 之 上 的 抽象 层次 。 它 允许 开发 者 在 恰当 的 抽象 层 
EATS R -o 


领域 特定 语言 允许 所 有 抽象 层级 和 应 用 程序 中 
0 























11.11 小 结 


系统 也 应 该 是 整洁 的 。 侵 害 性 架构 会 潭 炎 领 域 
逻辑 ， 冲 击 敏捷 能 力 。 当 领域 逻辑 受到 困扰 ， 质 量 
也 就 堪忧 ， 因 为 缺陷 更 易 隐 泸 ， 用 户 故 事 更 难 实 
现 。 当 敏捷 能 力 受 到 损害 时 ， 生 产 力也 会 降低 ， 
TDDIN IANA RIAA o 


在 所 有 的 抽象 层级 上 ， 意 图 都 应 该 清晰 可 辩 。 
只 有 在 编写 POJO 并 使 用 类 方面 的 机 制 来 无 损 地 组 
合 其 他 关注 面 时 ， 这 种 事情 才 会 及 生 。 


无 论 是 设计 系统 或 单独 的 模块 ， 列 迄 了 使 用 大 
概 可 工作 的 最 简单 方案 。 
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[4] ERE: 见 [Spring]。 男 外 也 有 一 个 Spring.NET 
框 染 。 
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[8] JRVE: 即 无 需 手 工 修改 源 代码 。 
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真正 价值 在 于 用 简洁 和 模块 化 的 方式 指定 系统 行 


[12] JE: 见 [Spring] 和 [JBoss]。“ 纯 Java” 表 示 不 
使 用 AspectJ。 


http://www.theserverside.com/tt/articles/article.tss? 
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[15] JRE: 可 以 使 用 遵循 “约定 胜 于 配置 ”的 机 制 
和 Java 5 annotation 来 减少 外 露 的 连接 逻辑 ， 从 而 人 简 
化 这 个 例子 。 


http://www.onjava.com/pub/a/onjava/2006/05/17/stand: 
with-ejb3-java-persistence-api.html 。 





[7] MÈ: 参见 [AspectJ] 和 [Colyer]。 


[18] EÈ: BDUF 和 是 一 种 预先 设计 好 一 切实 现 的 
方式 ， 不 能 与 先 做 设计 Cup-front design) 的 良好 实 
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[19] JRE: 即便 在 构建 开始 之 后 ， 也 会 有 大 量 友 
代 去 的 考察 和 细节 讨论 。 


[20] JRE: “软件 物理 ”一 词 最 早 由 [Kolence] 提 
a 

[231] È: [Alexander] 的 著作 对 软件 社区 影响 至 
深 。 


[22] JE: 参见 [DSL]。[JMock] 是 创建 DSL 的 
Java API 的 优秀 范例 。 
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I5 a AK fe UR, REESE BE FB B VG] 
建 优 民 的 设计 ， 会 如 何 ? [EDI E XB TTL BE 
洞 见 代码 的 结构 和 设计 ， 更 轻易 地 应 用 SRP 和 DIP 
之 类 原则 ， 又 会 如 何 ? 假使 这 4 条 规则 有 利于 良好 
的 设计 “浮现 ”出 来 ， 又 会 如 何 ? 


我 们 中 的 许多 人 认为 ，Kent Beck 关 于 简单 设 
ir Hd 的 四 条 规则 ， 对 于 创建 具有 和 良好 设计 的 软件 有 
着 莫大 的 帮助 。 


e 据 Kent 所 述 ， 只 要 遵循 以 下 规则 ， 设 计 就 能 变 
得 “简单 "; 

. 运行 所 有 测试 

“不 可 重复 ， 

e 表达 了 程序 员 的 意图 

« 尽 可 能 减少 类 和 方法 的 数量 ， 

。 以 上 规则 按 其 重要 程度 排列 。 








12.2 简单 设计 规则 1:， 运行 所 有 测 
试 


设计 必须 制造 出 如 预期 一 般 工 作 的 系统 ， 这 和 是 
BRAR. RABETA- BEHER, BWR 
WUER iEn R TY AE LE fl I, AB 
FCAT AR ERE. 


STAM Ar SE AT AA Rt Wiz n] 
WANA. Ae, (AA. AHP WA A 
REA A SE) AN PY SEN ARS, 2E DBE o 


AISNE, RERAMA Ws SRE 
Ai^ BARRA BOTT ZR MSRP, NIA 
ORBAN fia] HA WG SS, WICC HE RAE ZE IH 
编写 较 易 测试 的 代码 。 所 以 ， 确 保 系 统 完全 可 测试 


人 


能 帮助 我 们 创建 更 好 的 设计 。 


对 灰 合 的 代码 难以 编写 测试 。 同 样 ， 编 写 测 试 
越 多 ， 驳 越 会 齐 循 DIP 之 类 规则 ， 使 用 依赖 注入 、 
接口 和 抽象 等 工具 尽 可 能 减少 硝 合 。 如 此 一 来 ， 设 
ThA KEHF . 


HMAK SAMAA RERIT UT fd H 














确 的 规则 ， 系 统 就 会 更 贴近 OO 低 耦合 度 、 高 内 萌 
度 的 目标 。 编 写 测试 引致 更 好 的 设计 。 





12.3 简单 设计 规则 2 一 4: FRY 


有 了 测试 ， 束 能 保持 代码 和 类 的 整洁 ， 方 法 束 
征 递增 式 地 重 构 代 码 。 添 加 了 几 行 代码 后 ， 就 要 暂 
停 ， 琢 魔 一 下 变化 了 的 设计 。 设 计 退 步 了 吗 ? 如 果 
是， 网 要 清理 它 ， 并 且 运 行 测试 ， 保 证 没有 破坏 任 
Epor 
AIR 。 

在 重 构 过 程 中 ， 可 以 应 用 有 关 优 秀 软 件 设计 的 
UAR. ERFARE, RESE, UIRE 
面 ， 模 其 化 系统 性 关注 面 ， 绾 小 函数 和 闫 的 矿 才 ， 
选用 更 好 的 名 称 ， 如 此 等 等 。 这 也 是 应 用 简单 设计 
后 三 条 规则 的 地 方 : 消除 重复 ， 保 证 表达 力 ， 尽 可 
能 减少 类 和 方法 的 数量 。 














12.4 不 可 重复 


重复 是 拥有 民 好 设计 系统 的 大 敌 。 它 代表 着 额 
外 的 工作 、 额 外 的 风险 和 额外 且 不 必要 的 复杂 度 。 
重复 有 多 种 表现 。 极 其 雷同 的 代码 行当 然 是 重复 。 
类 似 的 代码 往往 可 以 调整 得 更 相似 ， 这 样 就 能 更 容 
易 地 进行 重 构 。 重 复 也 有 实现 上 的 重复 等 其 他 一 些 
形态 。 例 如 ， 在 茶 个 群集 类 中 可 能 会 有 两 个 方法 : 


int size() {} 
boolean isEmpty() {} 


这 两 个 方法 可 以 分 别 实现 。isEmpty 方 法 跟踪 
一 个 布尔 值 ， 而 size 方 法 则 跟踪 一 个 计数 器 。 或 
者 ， 也 可 以 通过 在 isEmpty 中 使 用 size 方 法 来 消除 重 
复 ; 


boolean isEmpty() { 
return 0 == size(); 


























J 








要 想 创建 整 洲 的 系统 ， 需 要 有 消除 重复 的 意 
愿 ， 即 便 对 于 短 短 几 行 也 是 如 此 。 例 如 以 下 代码 : 











public void scaleToOneDimension( 
float desiredDimension, float imageDimension) { 
if (Math.abs(desiredDimension - imageDimension) « errorThresho 
ld) 
return; 
float scalingFactor - desiredDimension / imageDimension; 
scalingFactor - (float)(Math.floor(scalingFactor * 100) * 0.01 
f); 


RenderedOp newImage = ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor); 
image.dispose(); 


System.gc(); 
image = newImage; 


public synchronized void rotate(int degrees) { 
RenderedOp newImage = ImageUtilities.getRotatedImage( 
image, degrees); 
image.dispose(); 
System.gc(); 
image = newImage; 


j 





要 保持 系统 整洁 ， 应 该 消除 
scaleToOneDimension 和 rotate 方 法 里 面 的 少量 重 





public void scaleToOneDimension( 
float desiredDimension, float imageDimension) { 
if (Math.abs(desiredDimension - imageDimension) « errorThresho 
ld) 
return; 
float scalingFactor - desiredDimension / imageDimension; 
scalingFactor - (float)(Math.floor(scalingFactor * 100) * 0.01 
f); 
replaceImage(ImageUtilities.getScaledImage( 


image, scalingFactor, scalingFactor)); 


j 


public synchronized void rotate(int degrees) { 
replacelImage(ImageUtilities.getRotatedImage(image, degrees)); 


j 


private void replacelmage(RenderedOp newImage) { 


image.dispose(); 


System.gc(); 


image - newImage; 











做 了 一 点 点 共性 抽取 后 ， 我 们 意识 到 已 经 违反 
了 了 SRP 原则 。 所 以 ， 可 以 把 一 个 新 方法 分 解 到 男 外 
的 类 中， 从 而 提升 其 可 见 性 。 团 队 中 的 其 他 成 员 也 
许 会 及 现 进一步 抽象 新 方法 的 机 会 ， 并 且 在 其 他 场 





景 中 复 用 之 。 “小 规模 复 用 ”可 大 量 降低 系统 复杂 
D ERN: 必须 理解 如 何 实现 小 规 
间 复 用 。 


模板 方法 模式 由 是 一 种 移 除 高 层级 重复 的 通 
用 技巧 。 例 如 : 





public class VacationPolicy { 

public void accrueUSDivisionVacation() ( 
// code to calculate vacation based on hours worked to date 
E x24 
// code to ensure vacation meets US minimums 
II ux 
// code to apply vaction to payroll record 
pS AP 

} 

public void accrueEUDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
LI APT 
// code to ensure vacation meets EU minimums 
// ... 
// code to apply vaction to payroll record 
24 sis 








除了 计算 法 定 最 少数 量 假期 的 部 分 ， 
accrueUSDivisionVacation 和 accrueEuropeanDivision 
中 有 大 量 代 码 雷 同 。 那 部 分 的 算法 ， 依 所 
工 类 型 而 变 。 


可 以 通过 应 用 模板 方法 模式 来 消除 明显 的 重 


复 。 


abstract public class VacationPolicy { 
public void accrueVacation() { 
calculateBaseVacationHours(); 


alterForLegalMinimums|(); 


applyToPayroll(); 


Jj 


private void calculateBaseVacationHours() { /* ... */ Y; 
abstract protected void alterForLegalMinimums(); 
private void applyToPayroll() ( /* ... */ }; 


j 


public class USVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimums() { 
// US specific logic 
} 


} 


public class EUVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimums() { 
// EU specific logic 
} 
} 





子 类 填充 了 accrueVacation 算 法 中 的 “空洞 >， 提 
供 不 重 复 的 信息 。 








12.5 表达 力 


我 们 中 的 大 多 数 人 都 经 历 过 费解 代码 的 纠缠 。 
我 们 中 的 许多 人 目 己 残 编 写 过 费解 的 代码 。 写 出 目 
ci 能 理解 的 代码 很 容易 ， 因 为 在 写 这 些 代 码 时 ， 我 
们 正 深 入 于 要 解决 的 问题 中 。 代 码 的 其 他 维护 者 不 
会 那么 深入 ， 也 束 不 易 理 解 代 人 码 。 


软件 项 目的 主要 成 本 在 于 长 期 维护 。 为 了 在 修 
改 时 尽量 降低 出 现 缺陷 的 可 能 性 ， 很 有 必要 理解 系 
统 是 做 什么 的 。 当 系统 变 得 越 来 越 复 森 ， 开 友 者 下 
需要 越 来 越 多 的 时 间 来 理解 它 ， 而 且 也 极 有 可 能 误 
解 。 所 以 ， 代 码 应 当 清 晰 地 表达 其 作者 的 意图 。 作 
者 把 代码 与 得 越 清 晰 ， 其 他 人 花 在 理解 代码 上 的 时 
间 也 融 越 少 ， 从 而 减少 缺陷 ， 缩 减 维护 成 本 。 


可 以 通过 选用 好 名 称 来 表达 。 我 们 想 要 听 a 到 好 
类 名 和 好 函数 名 ， 而 且 在 合 看 其 权 贡 时 个 会 大 Wc 一 


惊 。 























也 可 以 通过 保持 函数 和 类 尺寸 短小 来 表达 。 短 
小 的 类 和 函数 通常 易于 命名 ， 吻 于 编写 ， 易 于 理 
fif o 


还 可 以 通过 采用 标准 命名 法 来 表达 。 例 如 ， 设 


计 模 式 很 大 程度 上 就 关乎 沟通 和 表达 。 通 过 在 实现 
这 些 模式 的 类 的 名 称 中 采用 标准 模式 名 ， 例 如 
COMMAND 或 VISITOR， 就 能 充分 地 向 其 他 开发 者 
描述 你 的 设计 。 


编写 民 好 的 单元 测试 也 具有 表达 性 。 测 试 的 主 
要 目的 之 一 融 是 通过 实例 起 到 文档 的 作用 。 读 到 测 
试 的 人 应 该 能 很 快 理解 茶 个 类 是 做 什么 的 。 


不 过 ， 做 到 有 表达 力 的 最 重要 方式 却 是 符 试 
。 有 太 多 时 候 ， 我 们 写 出 能 工作 的 代码 ， 就 转移 到 
下 一 个 问题 上 ， 没 有 下 是 功夫 调整 代码 ， 让 后 来 者 
SI PST pn 
Ce 


ATL, 27D PRF ZIE., HE nb 
间 在 每 个 函数 和 类 上 。 选 用 较 好 的 名 称 ， 将 大 函数 
切 分 为 小 函数 ， 时 时 照 指 上 自己 创建 的 东西 。 用 心 古 
最 珍 贯 的 资源 。 


























12.6 ” 尽 可 能 少 的 关 和 方法 


即便 是 消除 重复 、 代 码 表达 力 和 SRP 等 最 基础 
的 概念 也 会 被 过 度 使 用 。 为 了 保持 类 和 函数 短小 ， 
我 们 可 能 会 造 出 太 多 的 细小 类 和 方法 。 所 以 这 条 规 
则 也 主张 函数 和 类 的 数量 要 少 。 


类 和 方法 的 数量 太 多 ， 有 时 是 由 坚 无 意义 的 教 
条 主义 导致 的 。 例 如 ， 某 个 编码 标准 就 坚 称 应 当 为 
每 个 类 创建 接口 。 也 有 开发 者 认为 ， 字 段 和 行为 必 
须 切 分 到 数据 类 和 行为 类 中 。 应 该 抵制 这 类 教条 ， 
采用 更 实用 的 手段 。 


我 们 的 目标 是 在 保持 函数 和 类 短小 的 同时 ， 你 
持 整 个 系统 短小 精 悍 。 不 过 要 记 住 ， 这 在 天 于 简单 
设计 的 四 条 规则 里 面 是 优先 级 最 低 的 一 条 。 所 以 ， 
尺 省 使 类 和 函数 的 数量 尽量 少 是 很 重要 的 ， 但 更 重 
要 的 却 是 测试 、 消 除 重复 和 表达 力 。 























12.7 小 结 


有 没有 能 蔡 代 经 验 的 一 套 简 单 实 践 手段 呢 ? 当 
然 不 会 有 。 男 一 方面 ， 本 章 中 写 到 的 实践 来 自 于 本 
书 作者 数 十 年 经 验 的 精练 总 结 。 芝 循 简单 设计 的 实 
E. 开发 者 不 必 经 年 学 习 吏 能 掌握 好 的 原则 和 
I o 
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编写 整洁 的 并 发 程序 很 难 一 一 非常 难 。 编 写 在 
单线 程 中 执行 的 代码 简单 得 多 。 编 写 表 面 上 看 来 不 
错 、 深 入 进去 却 文 离 破 碎 的 多 线程 代码 也 简单 。 系 
RHEE, PGI ME T o 


本 章 将 讨论 并 及 编程 的 需求 及 其 困难 之 处 ， 并 
给 出 一 些 对付 这 些 难 点 、 编 写 整 洁 的 并 及 代码 的 建 
议 。 最 后 ， 我 们 将 讨论 与 测试 并 发 代码 有 天 的 问 
题 。 


整洁 的 并 友 编 程 是 个 复杂 话题 ， 值 得 用 一 整 本 
书 来 讨论 。 本 书 只 做 概览 ， 并 在 “并 及 编程 I" 一 章 
中 提供 更 详细 的 指引 。 如 条 你 只 是 对 并 及 好 奇 ， 阅 
读本 半 就 足够 了。 如 果 你 需要 更 深入 地 理解 并 友 ， 
就 应 读 完 整个 指引 章节 。 














13.1 ”为 什么 要 并 发 


并 发 是 一 种 解 耦 策略 。 它 帮助 我 们 把 做 什么 
《目的 ) 和 何 时 (时 机 ) 做 分 解 开 。 在 单线 程 应 
用 中 ， 目 的 与 时 机 KARS, IRN RR BEG 
堆栈 退 踪 即 可 断定 应 用 程序 的 状态 。 调 试 这 种 系统 
的 程序 员 可 以 设 定 断 点 或 者 断 点 序列 ， 通 过 奏 看 到 
达 哪 个 断 点 来 了 解 系统 状态 。 


ARS H BS 与 时 机 能 明显 地 改进 应 用 程序 的 吞 
吐 量 和 结构 。 从 结构 的 角度 来 看 ， 应 用 程序 看 起 来 
更 像 是 许多 人 台 协 同 工 作 的 计算 机 ， 而 不 是 一 个 大 循 
环 。 系 统 因此 会 更 易于 被 理解 ， 给 出 了 许多 切 分 关 
注 面 的 有 力 手 段 。 


例如 ，Web 应 用 的 Servlet 标 准 模式 。 这 类 系统 
运行 于 Web 或 EJB 容 器 的 保护 们 之 下 ，Web 或 EJB 为 
你 部 分 地 处 理 并 发 问题 。 当 有 Web 请 求 时 ，servlet 
束 会 异步 执行 。Servlet 程 序 员 无 需 管理 所 有 的 请 
求 。 原 则 上 ， 每 次 servlet 是 在 自己 的 小 世界 中 执 
行 ， 与 其 他 servlet 的 执行 是 分 离 的 。 


DAE. WAR EAB fn] AE, tE mi 3c BE XK — 
mf. bk, WebRas he HEN fd d EX S ESE 
差 得 远 。Servlet 程 序 员 得 非常 警惕 、 非 篆 小 心地 保 
































证 并 友 程 序 不 出 错 。 同 样 ，servlet 模 式 的 结构 性 好 
处 还 是 很 明显 。 


但 结构 并 非 采用 并 发 的 唯一 动机 。 有 些 系统 对 
啊 应 时 间 和 吞吐 量 有 要 求 ， 需 要 手工 编写 并 发 解决 
方案 。 例 如 ， 考 虑 一 个 单线 程 信息 聚合 程序 ， 它 从 
许多 Web 站 点 获取 信息 ， 再 合并 写 入 日 志 中 。 因 为 
该 系统 是 单线 程 的 ， 它 会 逐个 访问 Web 站 点 ， 在 开 
始 下 一 个 之 前 等 待 当前 站 点 访问 完毕 。 每 天 的 执行 
时 间 必 须 少 于 24 个 小 时 。 然 而 ， 随 着 要 访问 的 站 点 
越 来 越 多 ， 采 集 所 有 数据 花费 的 时 间 也 越 来 越 多 ， 
最 终 超过 了 24 个 小 时 的 限制 。 单 线程 程序 许多 时 间 
花 在 等 待 Web 套 接 字 IO 结束 上 面 。 通 过 采用 同时 访 
问 多 个 站 点 的 多 线程 算法 ， 就 能 改进 性 能 。 


或 者 ， 考 虑 杀 个 每 次 花费 1 秒 钟 处 理 一 个 用 户 
请 求 的 系统 。 访 系统 在 用 户 量 较 少 的 时 候 啊 应 及 
时 ， 但 随 痢 用 户 数 增 加 ， 系 统 的 啊 应 时 间 也 增加 
了 。 没 人 想 排 在 150 个 人 后 面 ! 通 过 并 及 处 理 多 个 用 
户 请 求 ， 束 能 改进 系统 啊 应 时 间 。 


再 或 者 ， 考 夸 攻 个 解释 大 量 数据 集 、 但 只 在 处 
理 完 全 部 数据 后 给 出 一 个 完整 解决 方案 的 系统 。 或 
许可 以 在 独立 的 计算 机 上 处 理 每 个 数据 集 ， 那 样 的 
话 许 多 数据 集束 能 并 行 地 得 到 处 理 。 




















类 四 与 误解 


看 来 有 足够 的 理由 采用 并 发 方案 。 然 而 ， 如 前 
文 所 述 ， 并 发 编程 很 难 。 如 果 你 不 那么 细心 ， 束 
会 搞 出 不 堪 入 目的 东西 来 。 看 看 以 下 常见 的 迷 思 和 
误解 : 


(1) 并 发 总 能 改进 性 能 
并 及 有 时 能 改进 性 能 ， 但 只 在 多 个 线程 或 处 
理 器 之 间 能 分 享 大 量 等 待 时 间 的 时 候 管 用 。 事 情 没 
那么 简单 。 
(20 编写 并 发 程序 无 需 修 改 设计 
事实 上 ， 并 及 算法 的 设计 有 可 能 与 单线 程 系统 
的 设计 极 不 相同 。 目 的 与 时 机 BUG EE ROS AER 
结构 产生 巨大 影响 。 


(3) 在 采用 Web 或 EJB 容 器 的 时 候 ， 理 解 并 发 
问题 并 不 重要 


实际 上 ， 你 最 好 了 解 容 占 在 做 什么 ， 了 解 如 何 
对 付 本 章 后 文 将 提 到 的 并 发 更 新 、 死 锁 等 问题 。 


下 面 是 一 些 有 关 编 写 并 发 软件 的 中 肯 说 法 : 




















。 并 发 会 在 性 能 和 编写 额外 代码 上 增加 一 些 开销 


“正确 的 并 发 是 复杂 的 ， 即 便 对 于 简单 的 问题 也 
是 如 此 ; 

。 并 发 缺陷 并 非 总 能 重 现 ， 所 以 常 被 看 做 偶发 事 
件 (2) 而 忽略 ， 未 被 当做 真 的 缺陷 看 待 ; 

。 并 发 常常 需要 对 设计 策略 的 根本 性 修改 。 


13.2 ”挑战 
并 发 编程 为 何如 此 之 难 ? 来 看 看 下 面 这 个 小 型 





类 


public class X ( 
private int lastIdUsed; 
public int getNextId() { 
return ++lastIdUsed; 


j 


j 





比如 ， 创 建 x 的 一 个 实体 ， 将 lastIdUsed 设 置 为 
42， 在 两 个 线程 中 共享 这 个 实体 。 假 设 这 两 个 线程 
都 调用 getNextId( ) 方 法 ， 结 果 可 能 有 三 种 输出 : 


线程 一 得 到 值 43， 线 程 二 得 到 值 44，lastIdUsed 
7344; 
线程 一 得 到 值 44， 线 程 二 得 到 值 43，lastIdUsed 
7344; 
线程 一 得 到 值 43， 线 程 二 得 到 值 43，lastIdUsed 
为 43。 


第 三 种 结果 令 人 惊异  ， 当 两 个 线程 相互 影 
啊 时 束 会 出 现 这 种 情况 。 这 是 因为 线程 在 执行 那 行 
Java 代 码 时 有 许多 可 能 路 径 可 行 ， 有 些 路 径 会 产生 











错误 的 结果 。 有 多 少 种 不 同路人 径 呢 ?要 真正 回答 这 
个 问题 ， 需 要 理解 Just-In-Time 编 译 器 如 何 对 待 生 成 
的 字 节 人 码 ， 还 要 理解 Java 内 存 模型 认为 什么 东西 具 
有 原子 性 。 


简 管 一 下 ， 束 生成 的 字 节 码 而 言 ， 对 于 在 
getNextId 方 法 中 执行 的 那 两 个 线程 ， 有 12870 种 不 
同 的 可 能 执行 路 径 I 。 如 果 lastIdUsed 的 类 型 从 int 
变 为 1ong， 则 可 能 路 径 的 数量 将 增 至 2704156 种 。 当 
然 ， 多 数 路 径 都 得 到 正确 结果 。 间 题 是 其 中 一 些 不 
能 得 到 正确 结果 。 





13.3 ”并 有 防御 原则 


下 面 给 出 一 系列 防御 并 及 代码 问题 的 原则 和 技 
P. 


13.3.1 ”单一 权 黄 原则 


单一 权 责 原则 (SRP) bb 认为 ， 方 法 /类 /组 件 
应 当 只 有 一 个 修改 的 理由 。 并 发 设计 上 自身 足够 复杂 
到 成 为 修改 的 理由 ， 所 以 也 该 从 其 他 代码 中 分 离 出 
RK. PERE, FPA SLOMAN E e Bee A Bib 
生产 代码 中 。 下 面 是 要 考虑 的 一 些 问题 : 


。 并 发 相关 代码 有 自己 的 开发 、 修 改 和 调 优 生命 
周期 ; 

。 开 发 相关 代码 有 自己 要 对 付 的 挑战 ， 和 非 并 发 
相关 代码 不 同 ， 而 且 往 往 更 为 困难 ; 

e 即便 没 有 周边 应 用 程序 增加 的 负担 ， 写 得 不 好 
的 并 发 代码 可 能 的 出 错 方 式 数量 也 已 经 足 具 挑 
战 性 。 


建议 : 分 离 并 发 相关 代码 与 其 他 代码 [6] 。 
13.3.2 推论: 限制 数据 作用 域 


如 我 们 所 见 ， 两 个 线程 修改 共享 对 象 的 同一 字 
段 时 ， 可 能 互相 干扰 ， 导 致 未 预期 的 行为 。 解 诀 方 
案 之 一 是 采用 synchronized 关 键 字 在 代码 中 保护 一 
块 使 用 共享 对 象 的 临界 区 (critical section) 。 限 制 
临界 区 的 数量 很 重要 。 更 新 共享 数据 的 地 方 越 多 ， 
aloe nT He : 


e T SIRE B Plt FX 破坏 了 修 
改 共享 数据 的 代码 ; 

。 人 得 多 人 花 力气 保证 一 切 都 受到 有 效 防 护 〈 破 坏 了 
DRY 原 则 15 , 

e (EET SIE VAR. EIR IEF BE US. 


建议 : HERR; 严格 限制 对 可 能 被 共 
圣 的 数据 的 访问 。 


13.3.3 ”推论 : 使 用 数据 复 本 


避免 共 旱 数据 的 好 方法 之 一 不是 一 开始 丈 避 人 免 
共 至 数据 。 在 录 些 情形 下 ， 有 可 能 复制 对 象 并 以 只 
读 方 式 对 符 。 在 另外 的 情况 下 ， 有 可 能 复制 对 象 ， 
从 多 个 线程 收集 所 有 复 本 的 结果 ， 并 在 单个 线程 中 


合并 这 些 结 


如 果 有 避免 共 至 数据 的 简易 手段 ， 结 果 代 码 就 
会 大 大 减少 导致 错误 的 可 能 。 你 可 能 会 天 心 创建 客 


























外 对 象 的 成 本 。 值 得 试验 一 下 看 看 那 是 否 真 是 个 问 
题 。 然 而 ， 假 使 使 用 对 象 复 本 能 避免 代码 同步 执 
行 ， 则 因 避 免 了 锁定 而 省 下 的 价值 有 可 能 补偿 得 上 
额外 的 创建 成 本 和 垃圾 收集 开销 。 


13.3.4 推论 : 线程 应 尽 可 能 地 独立 


让 每 个 线程 在 自己 的 世界 中 存在 ， 不 与 其 他 线 
程 共有 旦 数据 。 每 个 线程 处 理 一 个 客户 器 请求 ， 从 不 
共有 至 的 源头 接纳 所 有 请 求 数据 ， 和 存储 为 本 地 变量 。 
这 样 一 来 ， 每 个 线程 部 像 古 世界 中 的 唯一 线程 ， 没 


有 同步 需要 。 


例如 ，HttpServlet 的 子 类 接收 所 有 以 参数 形式 
传递 给 doGet 和 doPost 方 法 的 信息 。 每 个 Servlet 都 像 
拥有 独立 虚拟 机 一 般 运 行 。 只 要 Servlet 中 的 代码 只 
使 用 本 地 变量 ，Servlet 束 不 会 导致 同步 问题 。 当 
然 ， 多 数 使 用 Servlet 的 应 用 程序 最 终 都 还 是 会 用 到 
类 似 数据 库 连 接 之 类 的 共享 资源 。 


建议 : 符 试 将 数据 分 解 到 可 被 独 立 线 程 〈 可 
能 在 不 同 处 理 器 上 ) 操作 的 独立 子 集 。 

















13.4 了 解 Java 库 


相对 于 之 前 的 版 本 ，Java 5 提供 了 许多 并 发 开 
发 方面 的 改进 。 在 用 Java 5 编写 线程 代码 时 ， 要 注 
RU PLA: 


。 使 用 类 库 提供 的 线程 安全 群集 ; 

e 使 用 executor 框 架 (executor framework) 执行 无 
天 任务 ; 

。 尺 可 能 使 用 非 锁定 解雇 方案 ; 

。 有 几 个 类 并 不 是 线程 安全 的 。 


线程 安全 群集 


当 Java 还 年 轻 时 ， Doug Lea 编 写 了 Concurrent 
Programming in Java (中 译 版 《Java 并 发 编程 》) 
教程 8 ， 同 时 开发 了 几 个 线程 安全 群集 ， 这 些 代 
码 后 来 成 为 JDK 中 java.util.concurrent 包 的 一 部 分 。 
该 代码 包 中 的 群集 对 于 多 线程 解决 方案 是 安全 的 ， 
执行 良好 。 实 际 上 ， 在 几乎 所 有 情况 下 ， 
ConcurrentHashMap 实 现 都 比 HashMap 表 现 得 好 。 它 
还 文 持 同步 并 友 谈 写 ， 也 拥有 文 持 非 线程 安全 的 合 
成 操作 的 方法 。 如 采 部 普 环 境 是 Java 5， 可 以 采用 
ConcurrentHashMap. 

















还 有 几 个 文 持 高 级 并 发 设计 的 类 。 以 下 是 其 中 
-小 部 分 ， 如 表 13-1 所 示 。 





表 13-1 文 持 高 级 并 发 设计 的 类 《部 分 ) 


可 在 一 个 方法 获取 在 男方 法 


Semaphore 











释放 的 锁 
的 “信号 ”的 一 种 实现 ， 有 计数 器 的 锁 


























CountDownLateh | 不 可 放 所 等 的 线程 之 前 ， 等 待 指 定数 量 事件 发 生 的 锁 ， 这 样 ， 所 有 











建议 : 检 读 可 用 的 类 。 对 于 Java， 和 掌握 


java.util.concurrent、java.util.concurrent.atomic 和 | 
java.util.concurrent.locks. 


13.5 ”了解 执行 模型 


有 几 种 在 并 发 应 用 中 切 分 行为 的 途径 。 要 讨论 
这 些 途 径 ， 我 们 需要 理解 一 些 基 础 定义 ， 如 表 13-2 
所 示 。 


表 13-2 ”基础 定义 




















开发 环境 中 有 着 固定 尺寸 或 数量 的 资源 。 例 如 数据 库 连 接 和 固定 尺寸 读 / 写 缓存 等 























一 时 刻 仅 有 一 个 线程 能 访问 共享 数据 或 共享 资源 





个 或 一 组 线程 在 很 长 时 间 内 或 永久 被 禁止 。 例 如 ， 总 是 让 执行 得 快 的 线程 先 运 
行 ， 假 如 执行 得 快 的 线程 没完 没 了 ， 则 执行 时 间 长 的 线程 就 会 “ 挨 饿 ” 















































两 个 或 多 个 线程 互相 等 待 执行 结束 。 每 个 线程 都 拥有 其 旦 需要 的 资源 ， 得 不 到 
其 他 线程 拥有 的 资源 ， 就 无 法 终止 


执行 次 序 一 致 的 线程 ， 每 个 都 想 要 起 步 ， 但 发 现 其 他 线程 已 经 “在 路 上 ”。 由 于 竞 步 的 
原因 ， 线 程 会 持续 尝试 起 步 ， 但 在 很 长 时 间 内 却 无 法 如 原 ， 甚 至 永远 无 法 启动 


有 了 这 些 定 义 ， 我 们 就 能 讨论 在 并 发 编程 中 用 
到 的 几 种 执行 模型 了 。 


13.5.1 生产 者 -消费 者 模型 [9] 


一 个 或 多 个 生产 者 线程 创建 菜 些 工作 ， 并 置 于 
绥 存 或 队列 中 。 一 个 或 多 个 消费 者 线程 从 队列 中 获 
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取 并 完成 这 些 工 作 。 生 产 者 和 消费 者 之 间 的 队列 是 
一 种 限定 资源 。 


13.5.2 ”读者 -作者 模型 MO] 


当 存 在 一 个 主要 为 读者 线程 提供 信息 源 ， 但 只 
俩 尔 被 作者 线程 更 新 的 共 诗 资源 ， 否 吐 量 就 会 是 个 
问题 。 增 加 吞吐 量 ， 会 导致 线程 饥饿 和 过 时 信息 的 
累积 。 更 新 会 影响 吞吐 量 。 协 调 读者 线程 ， 不 去 读 
作者 线程 正在 更 新 的 信息 〈 反 之 亦 然 ) ， 这 是 一 种 
笠 舌 的 平衡 工作 。 作 者 线程 倾 问 于 长 期 锁定 许多 读 
者 线程 ， 从 而 导致 存 吐 量 问 题 。 


挑战 之 处 在 于 平衡 读者 线程 和 作者 线程 的 需 
求 ， 实 现 正 确 操 作 ， 提 供 合理 的 吞吐 量 ， 避 免 线程 
饥饿 。 














13.5.3 ”宴席 哲学 家 [11 


KARP A EAE EA SF FAA 
SAN AFM SERS. RAP REA 
MAA. BFE ARA, BENET RS. S 
个 人 都 要 拿 起 叉子 吃饭 。 但 除非 手 上 有 两 把 叉子 ， 
否则 就 没 法 进食 。 如 果 左 边 或 右边 的 哲学 家 已经 取 
用 一 把 久子 ， 中 间 这 位 就 得 等 到 别人 吃 完 、 放 回 叉 
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了 许多 企业 级 应 用 中 进程 竞争 资源 的 情形 。 如 采 没 
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题 的 变种 。 请 研究 并 使 用 这 些 算 法 ， 这 样 ， 吉 到 并 
发 问题 时 你 束 能 有 人 解决 问题 的 准备 了 。 


建议 : 学 习 这 些 基 础 算法 ， 理 解 其 解决 方 


条 。 








13.6 ”警惕 同步 方法 之 间 的 依赖 


同步 方法 之 间 的 依赖 会 导致 并 发 代码 中 的 狐 独 
缺陷 。Java 语 言 有 synchronized 概 仿 ， 可 以 用 来 保护 
单个 方法 。 然 而 ， 如 果 在 同一 共享 类 中 有 多 个 同步 
方法 ， 系 统 就 可 能 写 得 不 太 正 确 了 14] 。 


建议 : 避免 使 用 一 个 共 圣 对 象 的 多 个 方法 。 


有 时 必须 使 用 一 个 共享 对 象 的 多 个 方法 。 在 这 
种 情况 发 生 时 ， 有 3 种 写 对 代码 的 手段 


e FET mmo 7 Fm ATE id FB — 
ATIR DERS m AMR BLE TO ERES s Js 
用 最 后 一 个 方法 的 代码 ; 

。 基 于 服务 端的 锁定 一 一 在 服务 站 内 创建 锁定 服 
务 站 的 方法 ， 调 用 所 有 方法 ， 然 后 解锁 。 主 客 
户 下 代码 调用 新 方法 ; 

。 适 配 服 务 站 创建 执行 锁定 的 中 间 层 。 这 是 
一 种 基于 服务 站 的 锁定 的 例子 ， 但 不 修改 原始 
ARH fig CAS o 









































13.7 保持 同步 区 域 人 微小 


关键 字 synchronized 制 造 了 锁 。 同 一 个 锁 维 护 
的 所 有 代码 区 域 在 任 一 时 刻 保证 只 有 一 个 线程 执 
行 。 锁 是 昂 贯 的 ， 因 为 它们 店 来 了 延迟 和 额外 开 
销 。 所 以 我 们 不 愿 将 代码 扔 给 synchronized 语 句 了 
事 。 另 一 方面 ， 临 界 区 [3 引 应 该 被 保护 起 来 。 所 
以 ， 应 该 尽 可 能 少 地 设计 临界 区 。 

有 些 天 真 的 程序 员 想 通过 扩大 临界 区 面积 达到 
这 个 目的 。 然 而 ， 将 同步 延展 到 最 小 临界 区 范围 之 
外 ， 会 增加 资源 争 用 、 降 低 执 行 效率 14 。 


建议 : 尽 可 能 减 小 同步 区 域 。 











13.8 ”很 难 编写 正确 的 关闭 代码 


编写 永远 运行 的 系统 ， 与 编写 运行 一 段 时 间 后 
平静 地 关闭 的 系统 是 两 码 事 。 


平静 关闭 很 难 做 到 。 常 见 问题 与 死 锁 中 有 
天 ， 线 程 一 直 等 竺 永远 不 会 到 来 的 信号 。 


例如 ， 想 象 一 个 系统 中 有 个 父 线程 分 裂 出 数 个 
子 线 程 ， 父 线程 等 每 所 有 子 线 程 结束 ， 然 后 释放 资 
源 并 关闭 。 如 果 其 中 一 个 子 线程 发 生死 锁 会 怎样 ? 
RATE BSR RA, MASAKI A AER 


BH. Gh — TBA 关闭 的 类 似 系统 。 父 
线程 告知 全 体 子 线程 放弃 任务 并 结束 。 如 果 其 中 两 
个 子 线程 正 以 生产 者 /消费 者 模型 操作 会 怎样 呢 ? 假 
设 生产 者 线程 从 父 线程 处 接收 到 信号 ， 并 迅速 关 
闭 。 消 费 者 线程 可 能 还 在 等 竺 生产 者 线程 友 来 消 
晨 ， 于 是 束 被 锁定 在 无 法 接收 到 天 闭 信号 的 状态 
中 。 它 会 死守 生产 者 线程 ， 水 不 结束 ， 从 而 导致 父 
线程 也 无 法 结 


这 类 情形 并 非 那 么 不 常见 。 如 果 你 要 编写 涉及 
平静 关闭 的 并 友 代 码 ， 请 多 预 留 一 些 时 间 搞 对 关闭 


过 程 。 

















建议 : 尽早 考虑 关闭 问题 ， 尺 早 令 其 工作 正 
钊 。 这 会 化 费 比 你 预期 更 多 的 时 间 。 检 视 既 有 算 
法 ， 因 为 这 可 能 会 比 想象 中 难得 多 。 


13.9 JW TAE Fe iS 


证 明代 码 的 正确 性 不 切实 际 。 测 试 并 不 能 确保 
正确 性 。 然 而 ， 好 的 测试 却 能 尽量 降低 风险 。 这 对 
于 所 有 单线 程 解决 方 采 都 是 对 的 。 当 有 两 个 或 多 个 
线程 使 用 同一 代码 段 和 共 字 数据， 事情 惑 变 得 非常 
复杂 了 。 


建议 : WSA ER HAM EAE 
的 编程 配置 、 系 统 配置 和 负载 条 件 下 频繁 运行 。 如 
果 测 试 失 败 ， 跟 躁 错 误 。 别 因为 后 来 测试 通过 了 后 
来 的 运行 就 急 略 失败 。 


有 一 大 堆 问 题 要 考虑 。 下 面 是 一 些 精练 的 建 
ix: 


e 将 伪 失 败 看 作 可 能 的 线程 问题 ; 
。 先 使 非 线程 代码 可 工作 ; 
编写 可 插 拔 的 线程 代码 ; 
编写 可 调整 的 线程 代码 ; 
运行 多 于 处 理 硕 数量 的 线程 ; 
在 不 同 平 合 上 运行 ; 

调整 代码 并 强迫 错误 发 生 。 





13.9.1 将 伪 失 败 看 作 可 能 的 线程 问题 


线程 代码 导致 "不 可 能 失败 的 ?失败 。 多 数 开 及 
者 缺乏 有 天 线程 如 何 与 其 他 代码 《〈 可 能 由 其 他 作者 
编写 ) 互动 的 直 和 党 。 线 程 代码 中 的 缺陷 可 能 在 一 干 
或 一 百 万 次 执行 中 才 会 显现 一 次 。 重 复 执行 想 要 复 
PL Ta] eS AGE MUFRE BF UE 
CBE. MFE RARR ARRE”. Hit BC 
这 种 偶发 事件 根本 不 存在 。“ 偶 发 事件 ?被 名 上 略 得 越 
久 ， 人 代码 就 越 有 可 能 挫 建 于 不 完善 的 基础 之 上 。 


建议 : 不 要 将 系统 错误 归咎 于 偶发 事件 。 
13.9.2” 先 使 非 线程 代 码 可 工作 

这 看 起 来 太 浅 显 ， 但 强调 一 下 不 无 益处 。 确 保 
线程 之 外 的 代码 可 工作 。 通 常 ， 这 意味 着 创建 由 线 
程 调用 的 POJO。POJO 与 线程 无 涉 ， 所 以 可 在 线程 
环境 之 外 测试 。 能 放 进 POJO 中 的 代码 越 多 越 好 。 


建议 : 不 要 同时 追踪 非 线程 缺陷 和 线程 缺 
陷 。 确 保 代码 在 线程 之 外 可 工作 。 


13.9.3 ”编写 可 插 拔 的 线程 代码 
编写 可 在 数 个 配置 环境 下 运行 的 线程 代码 : 


























。 单线 程 与 多 个 线程 在 执行 时 不 同 的 情况 ; 

© Dt SBM AS A Aah; 
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建议 : 编写 可 插 拔 的 线程 代码 ， 这 样 就 能 在 
不 同 的 配置 环境 下 运行 。 
13.9.4 编写 可 调整 的 线程 代码 


要 获得 民 好 的 线程 平衡 ， 币 第 需 要 试 错 。 一 开 
始 ， 在 不 同 的 配置 环境 下 监测 系统 性 能 。 要 人 允许 线 
程 数量 可 调整 。 在 系统 运行 时 允许 线程 及 生变 动 。 
允许 线程 依据 否 叶 量 和 系统 使 用 率 自我 调整 。 


13.9.5 ”运行 多 于 处 理 器 数量 的 线程 

系统 在 切换 任务 时 会 发 生 一 些 事 。 为 了 促使 任 
务 交 换 的 发 生 ， 运 行 多 于 处 理 器 或 处 理 器 核心 数量 
的 线程 。 任 务 交 换 越 频繁 ， 越 有 可 能 找到 错过 临界 
区 或 导致 死 锁 的 代 人 三 。 
13.9.6 ”在 不 同 平台 上 运行 


2007 年 ， 我 们 做 了 一 套 关 于 并 发 编程 的 课程 。 
该 课程 主要 在 OS X 下 开发 ， 在 运行 于 虚拟 机 的 




















Windows XP 上 展示 。 用 于 演示 的 测试 失败 条 件 ， 
在 OS X 上 要 比 在 XP 上 失败 得 更 频繁 。 


被 测试 的 代码 已 知 是 不 正确 的 。 这 正 强 调 了 不 
同 操作 系统 有 独 不 同 线程 策略 的 事实 ， 不 同 的 线程 
沉 略 影响 了 代码 的 执行 。 在 不 同 环境 中 ， 多 线程 代 
码 的 行为 也 不 一 样 US! 。 应 该 在 所 有 可 能 部 署 的 环 
境 中 运行 测试 。 


建议 : 尽早 并 经 向 地 在 所 有 目标 平台 上 运行 
线程 代码 。 


13.9.7 装置 试 错 代 码 


并 及 代码 中 藏 有 缺陷 ， 这 并 不 罕见 。 简 单 的 测 
试 往往 无 法 曝露 这 些 缺 陷 。 实 际 上 ， 人 缺陷 经 各 隐藏 
于 一 般 处 理 过 程 中 。 可 能 好 几 个 小 时 、 好 几 天 甚至 
好 几 个 星期 才 会 跳出 来 一 次 ! 


线程 中 的 缺陷 之 所 以 如 此 不 频繁 、 偶 发 、 难 以 
重 现 ， 是 因为 在 几 千 个 穿 过 及 弱 区 域 的 可 能 路 径 当 
中 ， 只 有 少数 路 径 会 真 的 导致 失败 。 经 过 会 导致 失 
败 的 路 径 的 可 能 性 惊人 地 低 。 所 以 ， 侦 测 与 调试 也 
| 


怎么 才能 增加 捕捉 住 如 此 罕见 之 物 的 机 会 ? 可 

















以 装置 代码 ， 增 加 对 Object.wait( )、Object.sleep( 
). Object.yield( ) 和 Object.priority( ) 等 方法 的 调用 ， 
改变 代码 执行 顺序 。 


这 些 方法 都 会 影 啊 执行 顺序 ， 从 而 增加 了 侦 调 
到 缺陷 的 可 能 性 。 有 问题 的 代码 ， 最 好 尽早 、 尽 可 
能 多 地 通 不 过 测试 。 

有 两 种 竣 兽 代码 的 方法 : 


o MEANA; 
。 目 动 化 。 





13.9.8 — fib 2g hi 

你 可 以 手工 向 代码 中 插入 wait( ). sleep( )、 
yield( ) 和 Ppriority() 的 调用 。 在 测试 某 段 玉手 的 代码 
时 ,， 正 当 如 此 操作 。 


下 面 是 个 例子 : 





public synchronized String nextUrlOrNull() ( 
if(hasNext()) ( 
String url - urlGenerator.next(); 
Thread.yield(); // inserted for testing. 
updateHasNext(); 
return url; 


return null; 


插入 对 yield() 的 调用 ， 将 改变 代码 的 执行 路 
径 ， 由 此 而 可 能 导致 代码 在 以 前 未 失败 过 的 地 方 失 
败 。 如 果 代 码 的 确 出 错 ， 那 并 非 是 因为 你 插入 了 
yield( ) 方 法 调用 中。 代码 出 错 了 ， 这 便 是 失败 的 


这 种 手法 有 许多 毛病 : 


e 你 得 手工 找到 合适 的 地 方 来 插入 方法 调用 ; 

。 你 怎么 知 着 在 哪里 插入 调用 、 插 入 什么 调用 ? 
。 不 必要 地 在 产品 环境 中 留 下 这 类 代码 ， 将 拖 慢 
代码 执行 速度 ; 

。 这 是 种 无 的 放 和 天 的 手段 。 你 可 能 找 不 到 缺陷 。 
实际 上 ， 这 不 在 你 把 握 之 中 。 


我 们 所 需要 的 ， 征 一 种 在 训 试 中 但 不 在 生产 中 
实现 的 手段 。 我 们 还 需要 为 多 次 运行 轻易 地 调整 配 
置 ， 从 而 增加 总 的 发 现 错误 机 会 。 


无 疑 ， 如 果 将 系统 分 解 为 对 线程 及 控制 线程 的 
类 一 无 所 知 的 POJO， 束 能 更 容易 地 找到 沪 置 代码 
的 位 置 。 而 且 ， 还 能 创建 许多 个 以 不 同方 式 调用 
sleep、yield 等 方法 的 POJO 测 试 。 














13.9.9 自动 化 


可 以 使 用 Aspect-Oriented Framework, CGLIB 
或 ASM 之 类 工具 通过 编程 来 装置 代码 。 例 如 ， 可 以 
使 用 有 单个 方法 的 类 : 


public class ThreadJigglePoint ( 
public static void jiggle() { 
} 


} 





可 以 在 代码 的 不 同位 置 调 用 这 个 方法 : 


public synchronized String nextUrlOrNull() { 

if(hasNext()) (1 
ThreadJiglePoint.jiggle(); 
String url - urlGenerator.next(); 
ThreadJiglePoint.jiggle(); 
updateHasNext(); 
ThreadJiglePoint.jiggle(); 
return url; 


return null; 


j 





如 此 ， 你 就 得 到 了 一 个 随机 选择 无 所 作为 、 睡 
眠 或 让 步 的 方面 。 


或 者 ， 想 象 ThreadJigglePoint 类 有 两 种 实现 。 
第 一 种 实现 jiggle 什 么 都 不 做 ， 在 生产 环境 中 使 用 。 


第 二 种 实现 生成 一 个 随机 数 ， 在 睡眠 、 让 步 或 笃 耳 
执行 间 做 选择 。 如 末 上 于 次 地 做 这 种 随机 测试 ， 大 
概 束 能 找到 一 些 缺陷 的 根源 。 假 如 训 试 都 通过 了 ， 
至 少 你 可 以 说 自己 已 谍 慎 对 每。 这 种 方法 看 似 有 后 
过 于 简单 ， 但 确 是 蔡 代 复杂 工具 的 一 种 可 选 方案 。 


有 一 种 叫做 ConTest 8! 的 工具 ， 由 IBM 开 发 ， 
能 做 类 似 的 事情 ， 但 做 法 却 稍微 复杂 些 。 

要 点 是 让 代码 “异动 "从 而 使 线程 以 不 同 次 序 
执行 。 编 写 恨 好 的 测试 与 “异动 >? 相 组 合 ， 能 有 效 地 
增加 发 现 错误 的 机 会 。 


建议 : BEAL RIM hH Fa TK o 








13.10 ”小 结 


并 发 代码 很 难 写 正确 。 加 入 多 线程 和 共享 数据 
后 ， 简 单 的 代码 也 会 变 成 置 梦 。 要 编写 并 发 代码 ， 
就 得 严格 地 编写 整 济 的 代码 ， 人 否则 将 面临 微细 和 不 
MUR AER AUC 
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分 离 了 线程 相关 代码 和 线程 无 天 代 码 的 POJO。 确 
保 在 测试 线程 相关 代码 时 上 只 是 在 测试 ， 没 有 做 其 他 
事情 。 线 程 相关 代码 应 该 保持 短小 和 目的 集中 。 


了 解 并 发 问题 的 可 能 原因 : 对 共 盏 数据 的 多 线 
程 操作 ， 或 使 用 了 公共 资源 池 。 类 似乎 静 关 闭 或 俘 
止 循环 之 类 边界 情况 尤其 国手 。 


学 习 关 库 ， 了 解 基 本 算法 。 理 解 类 库 提 供 的 与 
基础 算法 类 似 的 解决 问题 的 特性 。 


学 习 如 何 找 到 必须 锁定 的 代码 区 域 并 锁定 之 。 
不 要 锁定 不 必 锁 定 的 代码 。 避 免 从 锁定 区 域 中 调用 
其 他 锁定 区 域 。 这 需要 深刻 理解 东 物 是 否 已 共 旦 。 
尽 可 能 减少 共 孚 对 象 和 共 孚 范围 。 修 改 对 象 的 设 
计 ， 回 客户 代码 提供 共 盏 数据 ， 而 不 是 迫使 客户 代 
TAE PRAE SONGS e 

















问题 会 跳出 来 。 那 种 在 早期 没 跳出 来 的 问题 往 
往 是 偶发 的 。 这 种 所 谓 偶发 问 题 ， 通 营 仅 在 高 负载 
下 出 现 或 者 偶然 出 现 。 所 以 ， 你 要 能 在 不 同 平 台 
上 、 以 不 同 配置 持续 重复 运行 线程 代码 。 跟 随 TDD 
三 要 则 而 来 的 可 测试 性 意味 着 菜 种 程度 的 可 搬 拔 
性 ， 从 而 提供 了 在 大 量 不 同 配置 下 运行 代码 的 必要 


Xe 
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错误 代码 的 机 会 。 可 以 手工 做 ， 也 可 以 使 用 采种 目 
动 化 技术 。 尽 早 这 么 做 。 在 将 线程 代码 投入 生产 环 


境 前 ， 就 要 尺 可 能 多 地 运行 它 。 


只 要 采用 了 整洁 的 做 法 ， 做 对 的 可 能 性 就 有 翻 
ASS Sen o 
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[1] JRE: 来 自私 人 邮件 。 

[] RÈ: 宇宙 射线 、 狠 来 了 等 。《〈 译 者 按 : 作 
者 在 这 里 开 了 个 小 玩笑 。 程 序 员 竺 把 不 能 复 现 的 程 
序 错误 的 原因 归结 为 宇宙 射线 等 售 友 性 和 无 法 修正 
的 问题 。) 

[B] RÈ: 见 后 文 “ 深 入 控 据 ?一 节 。 


[4] Jk: 见 后 文 “ 路 径 数 量 ” 一 节 。 





[5] JY: [PPP]. 


[6] ” 原 注 ， 参见 后 文 “客户 端 / 服 务 器 的 例子 ”一 


[7] Jey: [PRAG]. 
[8] Jey: [Lea99]. 


[9]  JHit: http://en.wikipedia.org/wiki/Producer- 
consumer 。 


[10] JY: http://en.wikipedia.org/wiki/Readers- 
writers_problem 。 


[11] Jk 
yÈ: http://en.wikipedia.org/wiki/Dining_philosophers_ 





[12] JRE: 参见 后 文 “方法 之 间 的 依赖 可 能 破坏 
同步 代码 ”一 市 。 


[13] JRE: 临界 区 是 为 了 确保 程序 正确 而 要 阻止 
同时 使 用 的 代码 区 域 。 


[14] JE: 见 后 文 “增加 否 吐 量 ” 一 节 。 





[15] MIÈ: 参见 附录 A“ 死 锁 ” 一 市 。 


[16] RÈ: 你 是 否 知 道 ，Java 的 线程 模型 并 不 保 
证 线程 抢先 ? 现代 操作 系统 支持 抢先 线程 ， 所 以 你 
可 以 “免费 ”获得 这 一 特性 。 即 便 如 此 ，JVM 也 没有 
做 出 保证 。 


[17] JRE: 严格 说 来 并 非 如 此 。JVM 不 保证 抢先 
线程 ， 故 在 不 抢占 线程 的 系统 上 ， 某 个 特殊 的 算法 
可 能 一 直 能 工作 。 反 之 亦 然 ， 但 会 有 其 他 的 原因 影 
啊 。 


[18] JH 


注 : http;//www.alphaworks.ibm.com/tech/contest 。 








令 行 参数 解析 程序 的 案例 研究 


一 个 全 


对 





本 章 研究 一 个 逐步 改进 的 案例 。 你 将 看 到 一 个 
开始 还 不 错 ， 规 柑 扩 大 后 即 出 问题 的 模块 。 你 还 将 
看 到 这 个 模块 是 如 何 被 重 构 得 整洁 起 来 的 。 


我 们 中 的 大 多 数 人 部 会 过 到 解析 命令 行 参 数 的 
情况 。 如 果 没 有 就 手 的 工具 ， 就 得 遍历 传 入 main 函 
数 的 字符 串 数组 。 有 一 些 不 同 来 源 的 好 工具 ， 但 没 
有 一 个 是 最 符合 要 求 的 。 所 以 ， 我 当然 要 目 己 写 一 
个 。 我 把 它 叫 做 Args。 














Args 非 常 易 于 使 用 。 你 只 要 简单 地 用 输入 参数 
和 格式 化 字符 串 构 造 Args 类 ， 再 向 Args 实 体 询问 参 
数值 即 可 。 看 看 下 面 的 简单 例子 : 


代码 清单 14-1 Args 的 简单 用 法 








public static void main(String[] args) { 
try { 
Argsarg = new Args("1,p#,d*", args); 
boolean logging = arg.getBoolean('l1'); 
intport - arg.getInt('p'); 
Stringdirectory - arg.getString('d'); 
executeApplication(logging, port, directory); 


} catch (ArgsException e) { 
System.out.printf("Argumenterror:%s\n", e.errorMessage()); 








可 以 看 到 这 有 多 人 简单。 我 们 只 是 用 两 个 参数 创 
建 了 Args 类 的 一 个 实体 。 第 一 个 参数 是 格式 字符 
串 ， 或 范式 字符 串 : 1p#d*。 它 定义 了 三 个 命令 行 
BR. A—*, -, XÉ—44BAMBGGEGE. Bt, - 
p， 是 一 个 整数 参数 。 第 三 个 ，-d， 是 一 个 字符 串 
参数 。 向 Args 构 造 器 传 入 的 第 二 个 参数 就 是 向 main 
传 入 的 命令 行 参数 数组 。 


如 条 构造 器 正 第 返回 ， 没 有 抛 出 ArgsException 
异 音 ， 则 命令 行 参 数 已 传 入 ，Args 实 体 随 时 待命 。 
使 用 getBoolean、getInteger 和 getString 等 方法 ， 可 以 
用 参数 名 称 获 得 参数 值 。 

















不 管 是 格式 化 字符 串 或 命令 行 参数 出 现 问题 ， 
残 会 抛 出 一 个 ArgsException 异 单 。 可 以 从 该 异 第 的 
errorMessage 中 获得 关于 错误 的 描述 。 





14.1 Args 的 实现 


代码 清单 14-2 是 Args 类 的 实现 。 请 仔细 阅读 
E FARE XUECRIZET E46 Y KA, fc dB EH 


代码 清单 14-2  Args.java 





package com.objectmentor.utilities.args; 


import static com.objectmentor.utilities.args.ArgsException.Err 
orCode.* 
import java.util.*; 


public class Args { 
private Map«Character, ArgumentMarshaler» marshalers; 


private Set«Character» argsFound; 
private ListIterator<String> currentArgument; 


public Args(String schema, String[] args) throws ArgsException 
{ 
marshalers = new HashMap<Character, ArgumentMarshaler>(); 
argsFound = new HashSet<Character>(); 


parseSchema(schema) ; 
parseArgumentStrings(Arrays.asList(args)); 


private void parseSchema(String schema) throws ArgsException { 
for (String element : schema.split(",")) 
if (element.length() > 0) 
parseSchemaElement(element.trim()); 


j 


private void parseSchemaElement(String element) throws ArgsExc 
eption ( 


char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() -- 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##") ) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else if (elementTail.equals("[*]")) 
marshalers.put(elementId, new StringArrayArgumentMarshaler 
0); 
else 
throw new ArgsException(INVALID ARGUMENT FORMAT, elementId 
, elementTail); 


j 


private void validateSchemaElementId(char elementId) throws Ar 
gsException { 
if (!Character.isLetter(elementId)) 
throw new ArgsException(INVALID ARGUMENT NAME, elementId, 
null); 


} 


private void parseArgumentStrings(List<String> argsList) throw 
s ArgsException 


{ 
for (currentArgument = argsList.listIterator(); currentArgum 
ent.hasNext();) 
{ 
String argString = currentArgument.next(); 
if (argString.startsWith("-")) ( 
parseArgumentCharacters(argString.substring(1)); 
) else ( 
currentArgument.previous(); 
break; 
} 
} 
} 


private void parseArgumentCharacters(String argChars) throws A 
rgsException { 
for (inti = 0; i < argChars.length(); i++) 


parseArgumentCharacter(argChars.charAt(i)); 


j 


private void parseArgumentCharacter(char argChar) throws ArgsE 
xception { 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m == null) { 
throw new ArgsException(UNEXPECTED ARGUMENT, argChar, null 
); 
) else ( 
argsFound.add(argChar); 
try { 
m.set(currentArgument); 
) catch (ArgsException e) { 
e.setErrorArgumentId(argChar); 
throw e; 
} 
} 
} 


public boolean has(char arg) { 
return argsFound.contains(arg); 


j 


public int nextArgument() ( 
return currentArgument.nextIndex(); 


j 


public boolean getBoolean(char arg) { 
return BooleanArgumentMarshaler.getValue(marshalers.get(arg) 
); 
} 


public String getString(char arg) { 
return StringArgumentMarshaler.getValue(marshalers.get(arg)) 


j 


public int getInt(char arg) { 
return IntegerArgumentMarshaler.getValue(marshalers.get(arg) 
); 
} 


public double getDouble(char arg) { 
return DoubleArgumentMarshaler.getValue(marshalers.get(arg)) 


, 


j 


public String[] getStringArray(char arg) { 
return StringArrayArgumentMarshaler.getValue(marshalers.get( 
arg)); 
} 
} 





E, PRP SEJ ELA E30 ale ee 不 用 跳 
KBE, 也 不 用 先 看 后 面 的 部 分 。 唯 一 需要 先 看 的 








是 ArgumentMarshaler 的 定义 ， 这 部 分 分 我 有 着 略 

了 。 人 和 仔细 看 这 段 代 码 ， 你 应 该 能 理解 

ArgumentMarshaler 接 口 是 什 么 ， 其 派生 类 做 什么 。 

癌 你 展示 一 部 分 〈 如 代码 清单 14-3 一 14-6 
73 3 


代码 清单 14-3  ArgumentMarshaler.java 


public interface ArgumentMarshaler { 
void set(Iterator<String> currentArgument) throws ArgsExce 
ption; 


} 





代码 清单 14-4 BooleanArgumentMarshaler.java 





public class BooleanArgumentMarshaler implements ArgumentMarsha 
ler ( 
private boolean booleanValue - false; 


public void set(Iterator<String> currentArgument) throws ArgsE 
xception { 


booleanValue = true; 


j 


public static boolean getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof BooleanArgumentMarshaler) 
return ((BooleanArgumentMarshaler) am).booleanValue; 
else 


return false; 





代码 清单 14-5 StringArgumentMarshaler.java 


import static com.objectmentor.utilities.args.ArgsException.Err 
orCode.*; 


public class StringArgumentMarshaler implements ArgumentMarshal 
er { 
private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsE 
xception { 
try { 
stringValue = currentArgument.next(); 
} catch (NoSuchElementException e) { 
throw new ArgsException(MISSING_STRING); 


j 
j 


public static String getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof StringArgumentMarshaler ) 
return ((StringArgumentMarshaler) am).stringValue; 
else 


return ""; 





代码 清单 14-6 IntegerArgumentMarshaler.java 


import static com.objectmentor.utilities.args.ArgsException.Err 
orCode.* 


public class IntegerArgumentMarshaler implements ArgumentMarsha 
ler ( 
private int intValue - 0; 


public void set(Iterator<String> currentArgument) throws ArgsE 
xception { 
String parameter - null; 
try { 
parameter = currentArgument.next(); 
intValue - Integer.parseInt(parameter); 
) catch (NoSuchElementException e) { 
throw new ArgsException(MISSING INTEGER); 
) catch (NumberFormatException e) { 
throw new ArgsException(INVALID INTEGER, parameter); 
} 
} 


public static int getValue(ArgumentMarshaler am) { 
if (am != Null && am instanceof IntegerArgumentMarshaler) 
return ((IntegerArgumentMarshaler) am).intValue; 
else 


return 0; 





ArgumentMarshaler 的 其 他 派生 类 以 同样 的 模式 
处 理 double 和 String 数 组 ， 一 一 列 出 反而 阻碍 行文 。 
你 可 以 练习 自己 实现 它们 。 


还 有 些 信息 可 能 会 困扰 你 ， 错 误 码 常量 的 定 
义 。 这 些 是 在 ArgsException 类 “(代码 清早 14-7) 中 
定义 的 。 








代码 清单 14-7  ArgsException.java 





import static com.objectmentor.utilities.args.ArgsException.Err 
orCode.*; 


public class ArgsException extends Exception { 
private char errorArgumentId = 'N0'; 
private String errorParameter - null; 
private ErrorCode errorCode - OK; 


public ArgsException() {} 
public ArgsException(String message) ( super(message);) 


public ArgsException(ErrorCode errorCode) ( 
this.errorCode - errorCode; 


j 


public ArgsException(ErrorCode errorcode, String errorParamete 
r) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 


j 


public ArgsException(ErrorCode errorCode, 
char errorArgumentId,String errorParamete 
r)t 
this.errorCode - errorCode; 
this.errorParameter - errorParameter; 
this.errorArgumentId = errorArgumentId; 


j 


public char getErrorArgumentId() { 
return errorArgumentId; 


j 


public void setErrorArgumentId(char errorArgumentId) { 
this.errorArgumentId = errorArgumentId; 


j 


public String getErrorParameter() { 
return errorParameter; 


j 


public void setErrorParameter(String errorParameter) { 


this.errorParameter = errorParameter; 


j 


public ErrorCode getErrorCode() { 
return errorCode; 


j 


public void setErrorCode(ErrorCode errorCode) ( 
this.errorCode - errorCode; 


} 


public String errorMessage() { 
switch (errorCode) { 
case OK: 
return "TILT: Should not get here."; 
case UNEXPECTED ARGUMENT: 
return String.format("Argument -%c unexpected.", errorA 
rgumentId); 
case MISSING STRING: 
return String.format("Could not find string parameter for 
-%C.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -%c expects an integer 
but was '9*s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter fo 
r -%c.", 
errorArgumentId); 
case INVALID DOUBLE: 
return String.format("Argument -%c expects a double but w 
as '%s'.", 
errorArgumentId, errorParameter); 
case MISSING DOUBLE: 
return String.format("Could not find double parameter for 
-9c.", 
errorArgumentId); 
case INVALID ARGUMENT NAME: 
return String.format("'%c' is not a valid argument name. 


errorArgumentId); 


case INVALID ARGUMENT FORMAT: 
return String.format("'%s' is not a valid argument format 


errorParameter); 


return "" 


public enum ErrorCode ( 
OK, INVALID ARGUMENT FORMAT, UNEXPECTED ARGUMENT, INVALID AR 
GUMENT NAME, 
MISSING STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE 
} 





为 了 充实 这 么 一 个 简单 概念 的 细 方 ， 需 要 如 此 
多 代码 ， 这 很 值得 注意 。 原 因 之 一 是 我 们 使 用 了 
Java 这 种 忠 叫 型 语言 。 作 为 一 种 静态 类 型 语言 ， 需 
要 大 量 语句 才能 满足 类 型 系统 的 要 求 。 在 Ruby、 
Python 或 Smalltalk 等 语言 中 ， 程 序 会 短 很 多 [1 。 


请 再 次 阅读 这 段 代码 。 特 别 留 意 命 名 方式 、 函 
数 大 小 和 代码 格式 。 如 来 你 是 经 验 丰 晤 的 程序 员 ， 
可 能 会 对 风格 或 结构 有 着 这 样 或 那样 的 不 同 观 后 。 
不 过 ， 布 望 你 认为 这 段 程 友 总 体 上 编写 民 好 ， 有 着 
整洁 的 结构 。 





例如 ， 如 何 增加 新 参数 类 型 ， 如 日 期 或 复 林 数 
字 参 数 。 其 实现 手段 很 清楚 ， 而 且 只 需要 花 一 点 点 
力气 即 可 。 简 言 之 ， 只 需要 从 ArgumentMarshaler 浙 
生 一 个 新 类 ， 写 一 个 新 的 getXXX 函 数 ， 在 


parseSchemaElement 函 数 中 添加 一 个 新 的 case 语 
句 。 可 能 还 需要 添加 新 的 ArgsException.Errorcode 和 
新 错误 信息 。 


我 怎么 做 的 ? 


先 放松 一 下 神经 。 这 段 程 序 并 非 从 一 开始 就 写 
成 现在 的 样子 。 更 重要 的 是 ， 我 也 没 指 望 你 能 够 一 
次 过 写 出 整洁 、 床 亮 的 程序 。 如 采 说 我 们 从 过 去 几 
十 年 里 面 学 到 什么 东西 的 话 ， 那 惑 是 编程 是 一 种 拉 
艺 其 于 科学 的 东西 。 要 编写 整洁 代码 ， 必 须 完 号 及 
脏 代 人 码 ， 然 后 再 清 理 它 。 


你 应 该 不 会 对 此 感到 惊讶 。 我 们 在 小 学 就 学 过 
XFA. ABN, IN (通常 是 徒劳 地 ) 努力 让 
我 们 写作 文 草稿 。 他 们 告诉 我 们 ， 我 们 应 该 先 写 草 
稿 ， 再 写 二 稿 ， —1X M —IKI SB, 直至 写 出 终 
稿 。 他 们 尽力 告诉 我 们 ， 写 出 好 作文 是 一 个 逐步 改 
进 的 过 程 。 


多 数 新 手 程序 员 《〈 吏 像 多 数 小 学 生 一 样 ) 没有 
特别 认真 地 遵循 这 个 建议 。 他 们 相信 ， 首 要 任务 是 
写 出 能 工作 的 程序 。 只 要 程序 “能 工作 ”*”， 束 转移 到 
下 一 个 任务 上 ， 而 那个 “能 工作 ”的 程序 就 留 在 了 最 
后 那个 所 请 “能 工作 ”的 状态 。 多 数 老手 程序 员 部 知 
E, Re H BTA. 





























14.2 Args: fi 


代码 清单 14-8 展 示 了 Args 类 的 一 个 早期 版 本 。 
EREL”, ARE. 


代码 清单 14-8 Args.java〈 初 稿 ) 





import java.text.ParseException; 
import java.util.*; 


public class Args { 

private String schema; 

private String[] args; 

private boolean valid - true; 

private Set«Character» unexpectedArguments - new TreeSet«Chara 
cter>(); 

private Map<Character, Boolean> booleanArgs = 

new HashMap<Character, Boolean>(); 

private Map<Character, String> stringArgs = new HashMap<Charac 
ter, String>(); 

private Map<Character, Integer> intArgs = new HashMap<Characte 
r, Integer>(); 

private Set«Character» argsFound = new HashSet<Character>(); 

private int currentArgument; 

private char errorArgumentId = 'N0'; 

private String errorParameter = "TILT"; 

private ErrorCode errorCode - ErrorCode.OK; 


private enum ErrorCode { 
OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPE 
CTED ARGUMENT 


public Args(String schema, String[] args) throws ParseExceptio 
nt 
this.schema - schema; 
this.args - args; 
valid - parse(); 


j 


private boolean parse() throws ParseException { 

if (schema.length() == 0 && args.length == 0) 
return true; 

parseSchema( ); 

try { 
parseArguments(); 

} catch (ArgsException e) { 

} 


return valid; 


j 


private boolean parseSchema() throws ParseException ( 
for (String element : schema.split(",")) { 


if (element.length() > 0) { 
String trimmedElement - element.trim(); 
parseSchemaElement(trimmedElement ) ; 
} 
} 


return true; 


j 


private void parseSchemaElement(String element) throws ParseEx 
ception { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement (elementTail)) 
parseBooleanSchemaElement (elementId); 
else if (isStringSchemaElement(elementTail)) 
parseStringSchemaElement(elementId); 
else if (isIntegerSchemaElement(elementTail)) { 
parseiIntegerSchemaElement (elementId); 
) else ( 
throw new ParseException 
(String.format("Argument: %c has invalid format: 9s. 


elementId,elementTail),0); 


private void validateSchemaElementId(char elementId) throws Pa 
rseException { 
if (!Character.isLetter(elementId)) { 


throw new ParseException( 
"Bad character:"+elementId+"in Args format: "+schema, 0) 


} 
} 


private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementId, false); 


j 


private void parselntegerSchemaElement(char elementid) { 
intArgs.put(elementid, 0); 


j 


private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementId, ""); 


j 


private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 


j 


private boolean isBooleanSchemaElement(String elementTail) ( 
return elementTail.length() -- 0; 


j 


private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 


j 


private boolean parseArguments() throws ArgsException { 
for (currentArgument - 0; currentArgument « args.length; cur 
rentArgument++) { 
String arg = args[currentArgument]; 
parseArgument(arg); 
} 


return true; 


j 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements(arg); 


j 


private void parseElements(String arg) throws ArgsException { 


for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 


j 


private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode - ErrorCode.UNEXPECTED ARGUMENT; 
valid - false; 
} 
} 


private boolean setArgument(char argChar) throws ArgsException 
{ 
if (isBooleanArg(argChar ) ) 
setBooleanArg(argChar, true); 
else if (isStringArg(argChar ) ) 
setStringArg(argChar ); 
else if (isIntArg(argChar ) ) 
setIntArg(argChar); 
else 
return false; 


return true; 


j 


private boolean isIntArg(char argChar) (return intArgs.contain 
sKey(argChar);) 


private void setIntArg(char argChar) throws ArgsException { 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument ]; 
intArgs.put(argChar, new Integer(parameter )); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid - false; 
errorArgumentId - argChar; 
errorCode - ErrorCode.MISSING INTEGER; 


throw new ArgsException(); 
) catch (NumberFormatException e) { 
valid - false; 


errorArgumentId = argChar; 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw new ArgsException(); 
} 
} 


private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 
try { 
stringArgs.put(argChar, args[currentArgument ]); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid - false; 
errorArgumentId - argChar; 
errorCode - ErrorCode.MISSING STRING; 
throw new ArgsException(); 
} 
} 


private boolean isStringArg(char argChar) { 
return stringArgs.containsKey(argChar); 


j 


private void setBooleanArg(char argChar, boolean value) ( 
booleanArgs.put(argChar, value); 


j 


private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 


j 


public int cardinality() ( 
return argsFound.size(); 


j 


public String usage() ( 
if (schema.length() » 0) 
return "-[" + schema + "]"; 
else 
return ""; 


j 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 


throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage( ); 
case MISSING STRING: 
return String.format("Could not find string parameter 
for -%c.", 
errorArgumentId); 


case INVALID INTEGER: 
return String.format("Argument -%c expects an integer 
but was '%s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter 
for -%c.", 
errorArgumentId); 
} 


return ""; 


j 


private String unexpectedArgumentMessage() { 
StringBuffer message - new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 


J 


message.append(" unexpected." ); 


return message.toString(); 


j 


private boolean falseIfNull(Boolean b) { 
return b !- null && b; 
} 


private int zeroIfNull(Integer i) { 
return i == null ? 0 : i; 


} 


private String blankIfNull(String s) { 
return s == null? "" : s; 


j 


public String getString(char arg) { 
return blankIfNull(stringArgs.get(arg)); 


j 


public int getInt(char arg) { 
return zeroIfNull(intArgs.get(arg)); 


public boolean getBoolean(char arg) { 
return falselfNull(booleanArgs.get(arg)); 


public boolean has(char arg) { 
return argsFound.contains(arg); 


public boolean isValid() { 
return valid; 


private class ArgsException extends Exception { 


j 





硕 望 你 看 到 这 段 乱 七 作 粳 的 代码 时 ， 第 一 反应 
征 “ 他 没 就 此 疤 手 ， 真 令 人 局 兴 ! ”如 果 你 这 么 想 ， 





不 如 想 想 其 他 人 对 你 留置 在 齐 称 形 态 的 代码 的 想法 
吧 。 


实际 上 , “和 草稿 ”大概 会 是 你 对 这 段 代 码 的 最 高 
评价 。 它 显然 还 需 打 磨 。 实 体 变量 的 数量 多 到 吓 
人 。 诸 如 TILT 之 类 奇怪 的 字符 串 ，HashSet 和 
TreeSets， 还 有 那些 try-catch-catch 代 码 块 ， 组 成 了 
一 个 烂摊子 。 


我 不 想 写 出 一 个 烂 推 子 。 我 也 一 直 想 保持 一 切 


有 序 。 从 函数 和 变量 命名 ， 以 及 程序 的 粗略 染 构 
中 ， 你 可 以 看 出 这 一 点 。 不 过 ， 显 然 我 没 能 做 到 。 


混乱 是 逐渐 产生 的 。 更 早 的 版 本 并 不 如 此 及 
脏 。 例 如 ， 代 码 清单 14-9 展 示 了 一 个 早期 版 本 代 
A, AE H x RrBoolean2 7. 


代码 清单 14-9 ”Args.java (只 支持 Boolean) 





package com.objectmentor.utilities.getopts; 


import java.util.*; 


public class Args { 

private String schema; 

private String[] args; 

private boolean valid; 

private Set«Character» unexpectedArguments - new TreeSet«Chara 
cter>(); 

private Map<Character, Boolean> booleanArgs = 

new HashMap<Character, Boolean>(); 
private int numberOfArguments = 0; 


public Args(String schema, String[] args) { 
this.schema = schema; 
this.args = args; 
valid = parse(); 


j 


public boolean isValid() { 
return valid; 


j 


private boolean parse() ( 
if (schema.length() -- 0 && args.length -- 0) 
return true; 
parseSchema( ); 
parseArguments(); 
return unexpectedArguments.size() -- 0; 


j 


private boolean parseSchema() { 
for (String element : schema.split(",")) { 
parseSchemaElement (element); 


j 


return true; 


j 


private void parseSchemaElement(String element) { 
if (element.length() == 1) { 
parseBooleanSchemaElement (element); 
} 
} 


private void parseBooleanSchemaElement(String element) { 
char c - element.charAt(0); 
if (Character.isLetter(c)) (1 
booleanArgs.put(c, false); 
} 
} 


private boolean parseArguments() { 
for (String arg : args) 
parseArgument(arg); 
return true; 


j 


private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 


j 


private void parseElements(String arg) { 
for (int i = 1; i « arg.length(); I++) 
parseElement(arg.charAt(i)); 


j 


private void parseElement(char argChar) { 
if (isBoolean(argChar)) { 
numberOfArguments++; 
setBooleanArg(argChar, true); 
} else 
unexpectedArguments.add(argChar); 


j 


j 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 


j 


private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey(argChar); 


j 


public int cardinality() { 
return numberOfArguments; 


j 


public String usage() ( 
if (schema.length() » 0) 
return "-[" + schema + "]"; 
else 
return ""; 


j 


public String errorMessage() { 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage(); 
} else 
return ""; 


j 


private String unexpectedArgumentMessage() { 
StringBuffer message - new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 


i 


message.append(" unexpected."); 


return message.toString(); 


} 


public boolean getBoolean(char arg) { 
return booleanArgs.get(arg); 


j 





尽 过 你 可 能 对 这 段 代码 很 不 满意 ， 其 实 它 并 非 
如 此 之 烂 。 它 精练 、 人 简单 ， 吻 于 理解 。 然 而 ， 在 这 
段 代码 中 很 容易 找到 后 面 烂 挫 子 的 根源 。 很 消 楚 能 
看 到 小 问题 如 何 变 成 大 混乱 的 。 


注意， 后 来 的 混乱 代码 只 比 这 个 版 本 多 文 持 两 
种 参数 类 型 : String 和 integer。 只 增加 两 种 参数 类 型 
文 持 ， 驶 对 代码 产生 了 如 此 巨大 的 负面 影响 。 它 从 
有 某 种 可 维护 之 物 变 成 了 满 是 缺陷 的 东西 。 


我 逐步 添加 了 对 这 两 种 参数 类 型 的 支持 。 首 
先 ， 我 添加 对 String 参 数 的 支持 ， 就 像 这 样 : 


代码 清单 14-10  Args.java (Boolean 和 String ) 

















package com.objectmentor.utilities.getopts; 


import java.text.ParseException; 
import java.util.*; 


public class Args { 

private String schema; 

private String[] args; 

private boolean valid - true; 

private Set«Character» unexpectedArguments - new TreeSet«Chara 
cter>(); 

private Map<Character, Boolean> booleanArgs = 

new HashMap<Character, Boolean>(); 


private Map<Character, String> stringArgs = 
new HashMap<Character, String>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgument = 'N0'; 


enum ErrorCode { 
OK, MISSING_STRING} 


private ErrorCode errorCode = ErrorCode.OK; 


public Args(String schema, String[] args) throws ParseExceptio 
n { 
this.schema = schema; 
this.args = args; 
valid = parse(); 


j 


private boolean parse() throws ParseException { 
if (schema.length() -- 0 && args.length -- 0) 
return true; 
parseSchema( ); 
parseArguments(); 
return valid; 


j 


private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement - element.trim(); 
parseSchemaElement(trimmedElement ) ; 


j 
j 


return true; 


j 


private void parseSchemaElement(String element) throws ParseEx 
ception { 

char elementId = element.charAt(0); 

String elementTail = element.substring(1); 

validateSchemaElementId(elementId); 

if (isBooleanSchemaElement(elementTail)) 
parseBooleanSchemaElement (elementId); 

else if (isStringSchemaElement(elementTail)) 
parseStringSchemaElement(elementId); 


j 


private void validateSchemaElementId(char elementId) throws Pa 
rseException { 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 


"Bad character:" + elementId + "in Args format: " + sch 
ema, 0); 


j 
j 


private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementId, ""); 


private boolean isStringSchemaElement(String elementTail) 1 
return elementTail.equals("*"); 


j 


private boolean isBooleanSchemaElement(String elementTail) ( 
return elementTail.length() -- 0; 


j 


private void parseBooleanSchemaElement(char elementid) { 
booleanArgs.put(elementId, false); 


j 


private boolean parseArguments() { 
for (currentArgument = 0; currentArgument < args.length; cur 
rentArgument++ ) 


String arg = args[currentArgument ]; 
parseArgument(arg); 
} 


return true; 


j 


private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 


j 


private void parseElements(String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 


j 


private void parseElement(char argChar) { 
if (setArgument(argChar)) 
argsFound.add(argChar); 


else ( 
unexpectedArguments.add(argChar); 
valid - false; 
} 
} 


private boolean setArgument(char argChar) { 

boolean set = true; 

if (isBoolean(argChar)) 
setBooleanArg(argChar, true); 

else if (isString(argChar)) 
setStringArg(argChar, ""); 

else 
set - false; 


return set; 


j 


private void setStringArg(char argChar, String s) ( 
currentArgument++; 


try { 


stringArgs.put(argChar, args[currentArgument ]); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgument = argChar; 
errorCode = ErrorCode.MISSING_STRING; 
} 
} 


private boolean isString(char argChar) { 
return stringArgs.containsKey(argChar); 


j 


private void setBooleanArg(char argChar, boolean value) ( 
booleanArgs.put(argChar, value); 


j 


private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey(argChar); 


j 


public int cardinality() ( 
return argsFound.size(); 


j 


public String usage() ( 
if (schema.length() » 0) 
return "-[" + schema + "]"; 
else 
return ""; 


j 


public String errorMessage() throws Exception ( 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage( ); 
) else 
switch (errorCode) { 
case MISSING STRING: 
return String.format("Could not find string paramete 
r for -%c.", 
errorArgument); 
case OK: 
throw new Exception("TILT: Should not get here."); 
} 


return ""; 


j 


private String unexpectedArgumentMessage() { 
StringBuffer message - new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 


j 


message.append(" unexpected."); 


return message.toString(); 


j 


public boolean getBoolean(char arg) { 
return falseIfNull(booleanArgs.get(arg)); 


j 


private boolean falselIfNull(Boolean b) { 
return b -- null ? false : b; 


j 


public String getString(char arg) { 
return blankIfNull(stringArgs.get(arg)); 


j 


private String blankIfNull(String s) { 
return s == null? "" : s; 


public boolean has(char arg) { 
return argsFound.contains(arg); 


j 


public boolean isValid() { 
return valid; 





你 可 以 看 到 ， 代 码 开始 失去 控制 。 还 算 不 上 可 





介 ， 但 混乱 已 经 开始 生长 。 已 经 出 现 了 一 扒 东 西 ， 
不 过 还 没 煽 挥 。 增 加 对 整数 参数 类 型 的 支持 后 ， 那 
HE AR Pa y EC) AE D JS T o 


14.2.1. AREF s 


还 有 全 少 两 种 参数 类 型 要 添加 ， 而 且 情 形 一 定 
ER. WAR RAR, AME ALE ELIE, 
ANWR EE P AE EL. UIDES G4 
ZiMg— EOE, BUE ENA OL T . 


所 以 我 暂停 添加 特性 ， 开 始 重 构 。 由 于 网 添加 
了 String 和 integer 参 数 ， 我 知道 每 种 参数 类 型 都 需要 
在 三 个 主要 位 置 增加 新 代码 。 首 先 ， 每 种 参数 类 型 
都 要 有 解析 其 范式 元 素 、 从 而 为 该 种 类 型 选择 
HashMap 的 方法 。 其 次 ， 每 种 参数 类 型 都 需要 在 合 








行 字符 串 中 解析 ， 然 后 再 转换 为 真实 类 型 。 最 
， 每 种 参数 关 型 都 需要 一 个 getXXX 方 法 ， 按 照 
真实 类 型 同调 用 者 返回 参数 值 。 


许多 种 不 同类 型 ， 类 似 的 方法 听 起 来 像 是 
个 类 。ArgumentMarshaler 的 概念 就 是 这 样 产 生 的 。 


14.2.2 渐进 


器 坏 程 序 的 最 好 方法 之 一 束 是 以 改进 之 名 大 动 
其 结构 。 有 些 程序 永远 不 能 从 这 种 所 请“ 改进” 中 恢 
复 过 来 。 问 题 在 于 ， 很 难 让 程序 以 “改进 ”之 前 的 方 
AL.: 


为 了 避免 这 种 状况 发 生 ， 我 采用 了 测试 驱动 开 
发 的 规程 。 这 种 手法 的 核心 原则 之 一 是 保持 系统 始 
终 能 运行 。 换 言 之 ， 采 用 TDD， 我 不 会 允许 做 出 破 
e rm 
PELE 


我 需要 一 套 能 随 需 运 行 、 确 保 系统 行为 不 会 改 
动 的 目 动 化 测试 。 在 我 摘出 那个 烂 挫 子 的 同时 ， 也 
为 Args 类 创建 了 一 套 单元 测试 和 验收 测试 。 单 元 测 
试用 Java 写 成 ， 采 用 JUnit 管 理 。 验 收 测试 用 
FitNesse 以 wiki 页 形式 写成 。 我 可 以 随时 运行 这 些 测 
试 ， 如 果 测 试 通过 ， 束 能 打包 票 说 系统 以 我 期 望 的 





A 
后 
其 

















PE 


于 是 我 开始 做 出 大 量 小 规模 修改 。 每 次 修改 都 
将 系统 结构 同 ArgumentMarshaler 概 念 的 方 同 推动 。 
而 且 每 次 修改 后 ， 系 统 都 要 能 工作 。 第 一 个 修改 是 
TERT AR FE YS ArgumentMarshalerf] $6 Bi . 


代码 清单 14-11 [HlArgs.javaisJlll ArgumentMarshaler 








private class ArgumentMarshaler { 
private boolean booleanValue - false; 


public void setBoolean(boolean value) { 
booleanValue - value; 


j 


public boolean getBoolean() {return booleanValue; } 


j 


private class BooleanArgumentMarshaler extends ArgumentMars 
haler ( 


i 


private class StringArgumentMarshaler extends ArgumentMarsh 
aler { 


j 


private class IntegerArgumentMarshaler extends ArgumentMars 
haler ( 
} 


J 





显然 ， 这 什么 也 不 会 破坏 。 于 是 我 做 了 一 后 最 
简单 的 、 破 坏 性 尽 可 能 小 的 修改 。 我 修改 了 


HashMap， 采 用 ArgumentMarshaler， 使 之 文 持 
Boolean 参 数 。 


private Map<Character, ArgumentMarshaler 


> booleanArgs = 
new HashMap<Character, ArgumentMarshaler 


>(); 





这 个 修改 影响 到 少数 语句 ， 我 很 快 束 修正 了 。 





private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementId, new BooleanArgumentMarshaler ( ) 


); 
} 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.get 


(argChar ).setBoolean 
(value); 


j 


public boolean getBoolean(char arg) { 
return falselfNull(booleanArgs.get(arg).getBoolean() 


); 


NENNEN 

注意 ， 这 些 修改 正 古 在 我 之 前 提 到 的 那些 区 域 
之 内 所 做 的 : 参数 类 型 的 parse、set 和 get 操 作 。 不 
对 的 是 ， 即 便 修 改 如 此 细微 ， 有 些 测试 还 是 会 失 
败 。 仔 细 看 getBoolean， 可 以 看 到 如 果 用 y 去 调用 、 
而 并 没有 y 这 个 参数 ， 则 booleanArgs.get('y') 束 会 返 
null 值 ， 函 数 将 抛 出 一 个 NullPointerException 寞 
锅 。 函 效 falseIfNull 用 以 防止 这 种 状况 发 生 ， 但 我 
做 出 的 修改 却 导 致 该 函数 无 所 作为 。 


渐进 主义 要 求 我 在 做 其 他 修改 之 前 迅速 修正 这 
个 问题 。 修 正 并 不 费劲 。 我 只 是 把 对 null 值 的 检查 
移 了 个 位 置 。 再 也 不 用 检测 bollean 是 否 为 null， 而 


是 检查 ArgumentMarshaler 是 否 为 null。 


首先 ， 我 移 除 了 getBoolean 函 数 中 的 falseIfNull 
调用 。 现 在 它 没 什么 用 了 ， 所 以 我 也 删 去 了 这 个 汤 
数 。 测 试 还 是 以 同样 的 方式 失败 ， 所 以 我 确定 没有 
引入 新 的 错误 。 


public boolean getBoolean(char arg) { 
return booleanArgs.get(arg).getBoolean(); 
} 

















下 一 步 ， 我 把 函数 拆 解 为 两 行 ， 并 把 
ArgumentMarshaler 放 到 它 目 己 的 名 为 
argumentMarshaler 的 变量 中 [站 。 我 不 在 意 变量 名 太 
K, fH'E AUS EUER, 把 函数 搞 得 支离破碎 。 所 以 











我 把 变量 名 缩短 为 am[N5]。 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am 


- booleanArgs.get(arg); 
return am 


.getBoolean(); 





然后 再 放 入 检测 null 值 的 逻辑 。 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am !- null && 


am.getBoolean(); 





14.3 ”字符 串 参 数 


添加 String 参 数 和 添加 boolean 参 数 非 常 像 。 我 
要 修改 HashMap， 让 parse、set 和 get 函 数 能 工作 。 
跟 看 束 是 按部就班 ， 但 我 似乎 该 把 所 有 的 
marshalling (编组 〉 实现 放 到 ArgumentMarshaler 基 
类 而 不 是 派生 关中。 








private Map<Character, ArgumentMarshaler 


> stringArgs = 
new HashMap<Character, ArgumentMarshaler 


>(); 


private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementId, new StringArgumentMarshaler ( ) 


); 
} 


private void setStringArg(char argChar) throws ArgsExcepti 
on { 
currentArgument++; 


try { 
stringArgs.get 


(argChar).setString 


(args[currentArgument ] ); 
} catch (ArrayIndexOutOfBoundsException e) { 


valid = false; 

errorArgumentId - argChar; 

errorCode - ErrorCode.MISSING STRING; 
throw new ArgsException(); 


public String getString(char arg) { 
Args.ArgumentMarshaler am 


= stringArgs.get(arg); 
return am == null ? 


"" : am.getString(); 
j 


private class ArgumentMarshaler { 


private boolean booleanValue - false; 


private String stringValue; 


public void setBoolean(boolean value) 
booleanValue = value; 


j 


public boolean getBoolean() { 
return booleanValue; 


j 


public void setString(String s) { 


stringValue = s; 


{ 


public String getString() ( 


return stringValue == null ? "" : stringValue; 





同样 ， 也 是 每 次 修改 一 个 地 方 ， 持 续 运 行 测 
试 。 如 宋 测 斌 出错， 在 做 下 一 个 修改 前 确保 通过 。 














现在 你 应 该 明白 我 的 意图 了 。 一 旦 我 将 当前 的 
编组 行为 放 到 ArgumentMarshaler 基 类 中 ， 就 会 开始 
往 派 生 类 推 入 该 行为 。 这 样 ， 在 我 逐渐 修改 程序 的 
形状 时 ， 还 能 保持 一 切 正 第 。 


下 一 步 显 而 易 见 ， 把 int 参 数 的 相关 功能 放 到 
ArgumentMarshaler 里 面 。 同 样 ， 也 是 照 方 抓 药 。 








private Map<Character, ArgumentMarshaler> 


intArgs = 
new HashMap<Character, ArgumentMarshaler> 


(0; 


private void parseIntegerSchemaElement(char elementId) { 
intArgs.put(elementId, new IntegerArgumentMarshaler ( ) 


); 
} 


private void setIntArg(char argChar) throws ArgsException 
currentArgument++; 


String parameter = null; 
try { 
parameter = args[currentArgument | ; 


intArgs.get 


(argChar ).setInteger 


(Integer.parseInt(parameter )); 
} catch (ArrayIndexOutOfBoundsException e) { 


valid - false; 
errorArgumentId - argChar; 
errorCode - ErrorCode.MISSING INTEGER; 


throw new ArgsException(); 

) catch (NumberFormatException e) { 
valid - false; 
errorArgumentId - argChar; 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw new ArgsException(); 

} 

} 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = 


intArgs.get(arg); 
return am == null ? 0 


am.getInteger(); 


private class ArgumentMarshaler { 
private boolean booleanValue - false; 
private String stringValue; 
private int integerValue; 


public void setBoolean(boolean value) { 
booleanValue - value; 


j 


public boolean getBoolean() { 
return booleanValue; 


j 


public void setString(String s) { 
stringValue = Ss; 


j 


public String getString() { 
return stringValue == null ? "" : stringValue; 


public void setInteger(int i) { 


integerValue - i; 


public int getInteger() { 


return integerValue; 


当 所 有 的 编组 操作 都 放 到 了 ArgumentMarshaler 
中 ， 我 开始 同 派 生 类 移植 功能 。 第 一 步 是 把 
setBoolean 函数 放 SUA me 中 ， 
p 能 正确 调用 。 上 所 以 我 创建 了 一 个 抽象 的 set 方 
To 








private abstract 


class ArgumentMarshaler { 
protected 


boolean booleanValue - false; 
private String stringValue; 
private int integerValue; 


public void setBoolean(boolean value) { 
booleanValue = value; 


j 


public boolean getBoolean() { 
return booleanValue; 


} 

public void setString(String s) { 
stringValue = Ss; 

} 


public String getString() { 


return stringValue == null ? "" : stringValue; 


j 


public void setInteger(int i) { 
integerValue - i; 


j 


public int getInteger() { 
return integerValue; 


j 


public abstract void set(String s); 





然后 在 BooleanArgumentMarshaler 中 实现 set 方 





private class BooleanArgumentMarshaler extends ArgumentMarsha 
ler { 
public void set(String s) { 


booleanValue - true; 


Le 


最 后 ， 通 过 调用 set， 答 换 对 setBoolean 的 调 
用 。 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.get(argChar).set("true"); 





测试 仍然 全 部 通过 。 因 为 这 次 修改 导致 st 函数 
JJ f BooleanArgumentMarshaler E M, RMA 
ArgumentMarshaler 基 类 删除 了 setBoolean 方 法 。 


注意 ， 抽 象 函 数 set 有 一 个 String 参 数 ， 但 其 在 
BooleanArgumentMarshaler 中 的 实现 却 没 有 使 用 这 
个 参数 。 之 所 以 在 这 里 放 个 参数 ， 是 因为 我 知道 
StringArgumentMarshaler 和 
IntegerArgumentMarshaler 可 能 会 使 用 它 。 


IKE, FRAT Ager TEIN Al 
BooleanArgumentMarshaler 中 。 这 有 点 难看 ， 因 为 
返回 类 型 必须 是 Object， 且 在 这 里 需要 转换 为 
Booleanff . 

















public boolean getBoolean(char arg) { 


Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am !- null && (Boolean) 

am.get 

0; 

} 





为 了 编译 通过 ， 我 把 get 函 数 加 到 
ArgumentMarshaler 中 。 


private abstract class ArgumentMarshaler { 


public Object get() ( 


return null; 








这 样 一 来 ， 虽 然 可 以 编译 ， 但 却 无 法 通过 训 
试 。 只 要 将 get 修 改 为 抽象 方法 ， 并 在 


BooleanArgumentMarshaler 中 实现 ， 束 能 重新 通过 
iX. 


private abstract class ArgumentMarshaler { 
protected boolean booleanValue - false; 


public abstract 


Object get(); 
} 


Private class BooleanArgumentMarshaler extends ArgumentMarsh 
aler ( 
public void set(String s) { 
booleanValue = true; 


j 


public Object get() { 


return booleanValue; 








Ji OB. getset TIE ER Conr Fl 
BooleanArgumentMarshaler'P ! 这 样 我 就 可 以 从 
ArgumentMarshaler € [ff] #2 $R IH A getBoolean rk 2X, 


把 受 保护 的 booleanValue 变 量 向 下 移动 到 
BooleanArgumentMarshaler， 并 将 其 设置 为 private。 


对 于 String 也 照 此 办 理 。 我 修改 了 set 和 get 的 部 
团 方式， 删除 无 用 的 函数 ， 并 移动 了 变量 。 








private void setStringArg(char argChar) throws ArgsExceptio 


n { 
currentArgument++; 
try { 


stringArgs.get(argChar).set 


(args[currentArgument ] ); 
} catch (ArrayIndexOutOfBoundsException e) { 


valid - false; 
errorArgumentId - argChar; 
errorCode - ErrorCode.MISSING STRING; 
throw new ArgsException(); 
} 
} 
public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 
return am == null ? "" : (String) 
am.get 
(); 
} 


private abstract class ArgumentMarshaler { 
private int integerValue; 


public void setInteger(int i) { 
integerValue - i; 


j 


public int getInteger() { 


return integerValue; 


j 


public abstract void set(String s); 


public abstract Object get(); 


} 
private class BooleanArgumentMarshaler extends ArgumentMarsh 
aler ( 
private boolean booleanValue = false; 


public void set(String s) { 
booleanValue - true; 


j 


public Object get() { 
return booleanValue; 


j 
j 
private class StringArgumentMarshaler extends ArgumentMarsha 
ler { 
private String stringValue = ""; 


public void set(String s) { 
stringValue = s; 


} 


public Object get() { 
return stringValue; 


private class IntegerArgumentMarshaler extends ArgumentMarsh 


aler ( 
public void set(String s) { 


j 


public Object get() { 
return null; 











最 后 ， 我 为 integer 类 型 参数 重复 这 


稍稍 复杂 一 点 ， 因 为 integer 需 要 解析 ， 
会 抛 出 异 币 。 不 过 结果 会 更 好 ， 因 为 





NumberFormatException 的 概念 在 
IntegerArgumentMarshaler F KaJ S « 


ZX 个 过 程 。 这 


而 parse 操 作 





private boolean isIntArg(char argChar) {return intArgs.conta 
insKey(argChar);) 


private void setIntArg(char argChar) throws 
currentArgument++; 


String parameter = null; 
try { 
parameter = args[currentArgument ]; 


intArgs.get(argChar).set 


(parameter); 
) catch (ArrayIndexOutOfBoundsException eœ) 


valid - false; 
errorArgumentId - argChar; 
errorCode - ErrorCode.MISSING INTEGER; 


throw new ArgsException(); 


ArgsException { 


} catch (ArgsException 


e) 1 
valid - false; 
errorArgumentId - argChar; 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw e 
/ 
} 
} 


private void setBooleanArg(char argChar) { 
try { 


booleanArgs.get(argChar).set("true"); 
) catch (ArgsException e) { 


} 

} 

public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 
return am == null ? © : (Integer) 
am.get 

0; 

} 


private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 


j 


private class IntegerArgumentMarshaler extends ArgumentMarsha 
ler { 
private int intValue - 9; 


public void set(String s) throws ArgsException { 


try ( 


intValue = Integer.parseInt(s); 


) catch (NumberFormatException e) { 


throw new ArgsException(); 


public Object get() { 
return intValue; 





测试 当然 继续 通过 。 下 一 步 ， 我 要 删 兵 算法 顶 
谓 的 三 种 不 同 Map。 这 样 ， 整 个 系统 焉 变 得 更 通用 
了 了。 不过， 只 是 删除 它们 却 无 法 达到 目的 ， 因 为 那 
样 会 破坏 系统 。 反 之 ， 我 为 ArgumentMarshaler;i 过 加 
一 个 新 的 Map， 然 后 再 逐个 修改 那些 方法 ， 让 方法 
调用 这 个 新 Map。 





public class Args { 


private Map<Character, ArgumentMarshaler> booleanArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> stringArgs 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character,ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> marshalers 


new HashMap<Character, ArgumentMarshaler>() 


, 


private void parseBooleanSchemaElement(char elementId) { 
ArgumentMarshalerm = new BooleanArgumentMarshaler(); 


booleanArgs.put(elementiId, m); 
marshalers.put(elementId, m); 


j 


private void parseIntegerSchemaElement(char elementid) { 
ArgumentMarshaler m = new IntegerArgumentMarshaler(); 


intArgs.put(elementid, m); 
marshalers.put(elementId, m); 


j 


private void parseStringSchemaElement(char elementId) { 
ArgumentMarshaler m = new StringArgumentMarshaler ( ) 


stringArgs.put(elementId,m); 
marshalers.put(elementId, m); 





当然 ， 测 斌 还 是 通过 了 。 接 痢 ， 我 把 
isBooleanArg: 


private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 


j 





修改 成 这 样 : 





private boolean isBooleanArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 


return m instanceof BooleanArgumentMarshaler; 





测试 仍然 通过 。 于 是 我 修改 了 一 下 isIntArg 和 
isStringArg. 


private boolean isIntArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 


return m instanceof IntegerArgumentMarshaler; 


private boolean isStringArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof StringArgumentMarshaler; 


j 





测试 继续 通过 。 我 跟着 消除 了 对 marshaler.get 
的 重复 调用 : 


private boolean setArgument(char argChar) throws ArgsExcepti 








on ( 
ArgumentMarshaler m = marshalers.get(argChar); 


if (isBooleanArg(m 


)) 
setBooleanArg(argChar); 


else if (isStringArg(m 


)) 
setStringArg(argChar); 


else if (isIntArg(m 


)) 
setIntArg(argChar); 


else 
return false; 


return true; 


j 


private boolean isIntArg(ArgumentMarshaler m 


) i 


return m instanceof IntegerArgumentMarshaler; 
} 


private boolean isStringArg(ArgumentMarshaler m 


) i 


return m instanceof StringArgumentMarshaler; 
} 


private boolean isBooleanArg(ArgumentMarshaler m 


yo 


return m instanceof BooleanArgumentMarshaler; 


存在 三 个 isxxxArg 方 法 坚 无 道理 。 所 以 我 做 了 
内 联 修改 : 


private boolean setArgument(char argChar) throws ArgsExcepti 
on { 

ArgumentMarshaler m = marshalers.get(argChar); 

if (m instanceof BooleanArgumentMarshaler 


setBooleanArg(argChar); 
else if (m instanceof StringArgumentMarshaler 


) 
setStringArg(argChar); 


else if (m instanceof IntegerArgumentMarshaler 


setIntArg(argChar); 
else 
return false; 


return true; 


j 





下 一 步 ， 我 开始 在 set 函 数 中 使 用 marshaler 映 
射 ， 停 止 使 用 另外 三 个 映射 映射 。 从 boolean 开 始 : 


private boolean setArgument(char argChar) throws ArgsException 


{ 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler ) 
setBooleanArg(m 


); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(argChar); 
else if (m instanceof IntegerArgumentMarshaler ) 
setIntArg(argChar); 
else 
return false; 


return true; 


j 


private void setBooleanArg(ArgumentMarshaler m 


) i 


try { 
m 


.Set("true"); // was: booleanArgs.get(argChar).set("true") 


) catch (ArgsException e) ( 
} 
} 





测试 通过 ， 于 是 我 如 法 炮制 String 和 Integer 参 
数 。 这 样 我 束 能 把 有 些 丑 陋 的 异 第 管理 代码 整合 到 
setArgumentrK Zi rH , 


private boolean setArgument(char argChar) throws ArgsExcepti 


on ( 
ArgumentMarshaler m = marshalers.get(argChar); 


try ( 


if (m instanceof BooleanArgumentMarshaler) 


setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler ) 


setStringArg(m 


); 


else if (m instanceof IntegerArgumentMarshaler ) 
setIntArg(m 


); 
else 
return false; 


) catch (ArgsException e) { 


valid - false; 
errorArgumentId = argChar; 
throw e; 

} 


return true; 


j 


private void setIntArg(ArgumentMarshaler m 


) throws ArgsException { 


currentArgument++; 

String parameter = null; 

try { 
parameter = args[currentArgument ]; 
m 


.set(parameter); 
) catch (ArrayIndexOutOfBoundsException e) { 
errorCode - ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 
) catch (ArgsException e) { 


errorParameter = parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw e; 


j 
j 


private void setStringArg(ArgumentMarshaler m 


) throws ArgsException { 
currentArgument++; 


try { 
m 


.set(args[currentArgument | ); 
) catch (ArrayIndexOutOfBoundsException e) { 
errorCode - ErrorCode.MISSING STRING; 
throw new ArgsException(); 


j 
j 





离 彻底 删除 那 3 个 旧 映 射 的 时 机 越 来 越 近 了 。 
首先 ， 我 需要 修改 getBoolean 函 数 : 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am !- null && (Boolean) am.get(); 





public boolean getBoolean(char arg) { 


Args.ArgumentMarshaler am - marshalers.get(arg); 
boolean b - false; 

try { 

b = 

am !- null && (Boolean) am.get(); 


) catch (ClassCastException e) { 


b - false; 
} 
return b; 


| 


最 后 这 个 修改 可 能 令 人 吃惊 。 为 什么 我 会 突然 
决定 对 付 ClassCastException? 原因 是 我 有 一 组 单元 
测试 ， 还 有 用 FitNesse 编 写 的 一 组 验收 测试 。 
FitNesse 测 试 确认 ， 如 果 用 非 布 尔 值 参数 调用 
getBoolean， 应 该 返回 false。 可 单元 测试 的 结果 不 
是 这 样 。 而 到 此 时 为 止 ， 我 一 直 只 调用 单元 测试 8! 


o 





Jo X 


m 


多 改 把 另 一 个 对 boolean 映 射 的 使 用 抽 离 


private void parseBooleanSchemaElement(char elementId) { 
ArgumentMarshaler m - new BooleanArgumentMarshaler(); 


—boeoleanArgs-put(elementid; m); 


marshalers.put(elementId, m); 





如 此 我 们 就 能 删除 boolean 映 射 。 


public class Args { 


ArgumentMarshaler» stringArgs 
ArgumentMarshaler»(); 

ArgumentMarshaler» intArgs = 
ArgumentMarshaler»(); 

ArgumentMarshaler» marshalers = 
ArgumentMarshaler»(); 


private Map<Character, 
new HashMap<Character, 

private Map<Character, 
new HashMap<Character, 

private Map<Character, 
new HashMap<Character, 





接 下 来 ， 我 用 同样 的 手法 处 理 String 和 Integer 
参数 ， 对 boolean 参 数 做 了 一 点 清理 工作 。 


private void parseBooleanSchemaElement(char elementId) { 





marshalers.put(elementId, new BooleanArgumentMarshaler ( ) 


); 
} 


private void parseIntegerSchemaElement(char elementId) { 
marshalers.put(elementId, new IntegerArgumentMarshaler ( ) 


); 


j 


private void parseStringSchemaElement(char elementId) { 
marshalers.put(elementId, new StringArgumentMarshaler ( ) 


); 


} 

public String getString(char arg) { 
Args.ArgumentMarshaler am - marshalers. 
get(arg); 

try { 

return am -- null ? "" : (String) am.get(); 


) catch (ClassCastException e) { 


return ""; 
} 
} 
public int getInt(char arg) { 
Args.ArgumentMarshaler am - marshalers. 
get(arg); 
try { 
return am -- null ? 0 : (Integer) am.get(); 


) catch (Exception e) { 


return 0; 


j 


public class Args { 


. | hal | = 


private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 





接着 ， 由 于 那些 parse 方 法 没有 太 多 事 可 做 ， 我 
对 它们 进行 了 内 联 修改 : 


private void parseSchemaElement(String element) throws Parse 
Exception { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 


else if (isStringSchemaElement(elementTail)) 
marshalers.put(elementId, new StringArgumentMarshaler()); 


else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 


) else { 
throw new ParseException(String. format ( 
"Argument: %c has invalid format: %s.", elementId, e 
lementTail), 0); 


j 
j 














行 了 ， 下 面 来 看 看 全 景 吧 。 代 码 清 单 14-12 展 


示 了 Args 类 的 现状 。 


代码 清单 14-12 Args.java〈 首 次 重 构 后 ) 





package com.objectmentor.utilities.getopts; 


import java.text.ParseException; 
import java.util.*; 


public class Args { 
private String schema; 
private String[] args; 
private boolean valid - true; 
private Set«Character» unexpectedArguments - new TreeSet«C 
haracter>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set«Character» argsFound = new HashSet<Character>( 


); 


private int currentArgument; 


private char errorArgumentId = '*0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 


private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, INVALID_INTEGER, UNE 
XPECTED_ARGUMENT } 


public Args(String schema, String[] args) throws ParseExce 
ption { 


this.schema = schema; 
this.args = args; 
valid = parse(); 


j 


private boolean parse() throws ParseException { 

if (schema.length() == 0 && args.length == 0) 
return true; 

parseSchema( ); 

try 1 
parseArguments(); 

) catch (ArgsException e) { 

} 


return valid; 


j 


private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 
parseSchemaElement(trimmedElement ) ; 
} 
} 


return true; 


j 


private void parseSchemaElement(String element) throws Par 
seException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new BooleanArgumentMarshaler()) 


else if (isStringSchemaElement(elementTail)) 
marshalers.put(elementId, new StringArgumentMarshaler() 


else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler( 
)); 
) else { 
throw new ParseException(String. format ( 
"Argument: %c has invalid format: %s.", elementId 
, elementTail), 0); 
} 
} 


private void validateSchemaElementId(char elementId) throws 
ParseException { 

if (!Character.isLetter(elementId)) ( 

throw new ParseException( 
"Bad character:" + elementId + "in Args format: " 

+ schema, 0); 

} 
} 


private boolean isStringSchemaElement(String elementTail) { 


return elementTail.equals("*"); 


} 


private boolean isBooleanSchemaElement(String elementTail) 


i 
j 


private boolean isIntegerSchemaElement(String elementTail) 


i 
j 


private boolean parseArguments() throws ArgsException { 
for (currentArgument=0; currentArgument«args.length; curre 
ntArgument++) { 


return elementTail.length() == 0; 


return elementTail.equals("#"); 


String arg = args[currentArgument |; 
parseArgument(arg); 
} 
return true; 
} 
private void parseArgument(String arg) throws ArgsExceptio 
n { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) throws ArgsExceptio 
n { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(1i)); 
} 
private void parseElement(char argChar) throws ArgsExcepti 
on ( 


if (setArgument(argChar)) 
argsFound.add(argChar); 


else { 
unexpectedArguments.add(argChar); 
errorCode - ErrorCode.UNEXPECTED ARGUMENT; 
valid - false; 

} 


private boolean setArgument(char argChar) throws ArgsExcep 
tion { 
ArgumentMarshaler m - marshalers.get(argChar); 
try { 
if (m instanceof BooleanArgumentMarshaler ) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler ) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
else 
return false; 
) catch (ArgsException e) { 


valid - false; 
errorArgumentId - argChar; 
throw e; 


j 


return true; 


j 


private void setIntArg(ArgumentMarshaler m) throws ArgsExc 
eption { 


currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument ]; 


m.set(parameter ); 

) catch (ArrayIndexOutOfBoundsException e) { 
errorCode - ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 

) catch (ArgsException e) { 


errorParameter = parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw e; 


} 
j 


private void setStringArg(ArgumentMarshaler m) throws Args 
Exception { 
currentArgument++; 
try { 
m.set(args[currentArgument]); 
} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING STRING; 


throw new ArgsException(); 


j 
j 


private void setBooleanArg(ArgumentMarshaler m) { 
try { 
m.set("true"); 
) catch (ArgsException e) { 
} 
} 


public int cardinality() { 
return argsFound.size(); 


j 


public String usage() { 
if (schema.length() > 0) 


return "-[" + schema + "]'; 
else 
return ""; 


j 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage( ); 
case MISSING STRING: 
return String.format("Could not find string parameter 
for -%c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -%C expects an integer 
but was '9*s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer paramete 
r for -%c.", 
errorArgumentId); 


j 


return ""; 


j 


private String unexpectedArgumentMessage() 


StringBuffer message - new StringBuffer("Argument(s) 

for (char c : unexpectedArguments) { 
message.append(c); 

} 


message.append(" unexpected."); 


return message.toString(); 


} 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am - marshalers.get(arg); 
boolean b - false; 
try 1 
b = am !- null && (Boolean) am.get(); 
) catch (ClassCastException e) { 
b - false; 
return b; 
} 
public String getString(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? "" : (String) am.get(); 
) catch (ClassCastException e) { 
return ""; 
} 


} 


public int getInt(char arg) { 


Args.ArgumentMarshaler am - marshalers.get(arg); 
try { 

return am == null ? 0 : (Integer) am.get(); 
) catch (Exception e) { 

return O0; 
} 


} 


public boolean has(char arg) { 
return argsFound.contains(arg); 


j 


public boolean isValid() { 


"i 


return valid; 


} 
private class ArgsException extends Exception { 


} 

private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 


} 
private class BooleanArgumentMarshaler extends ArgumentMars 


haler { 
private boolean booleanValue = false; 


public void set(String s) { 
booleanValue - true; 


j 


public Object get() { 
return booleanValue; 


J 
j 


private class StringArgumentMarshaler extends ArgumentMarsh 


aler { 
private String stringValue = ""; 


public void set(String s) { 
stringValue = s; 


} 


public Object get() { 
return stringValue; 


} 
} 
private class IntegerArgumentMarshaler extends ArgumentMars 
haler { 
private int intValue = 0; 


public void set(String s) throws ArgsException { 


try { 
intValue = Integer.parseInt(s); 


) catch (NumberFormatException e) { 


j 
j 


throw new ArgsException(); 


public Object get() ( 
return intValue; 


j 


功夫 费 尽 ， 








还 是 有 点 失望 。 程 序 结构 好 了 一 点 ， 但 在 代码 顶端 还 是 有 那 一 堆 变量 ; 














在 setArgument 里 面 还 是 有 那么 恐怖 的 类 型 转换 操作 | 而 且 那 些 set 函 数 真 的 很 丑陋 
。 了 网 别提 那些 错误 处 理 操 作 了 。 前 头 要 做 的 事 还 很 多 。 






































我 真是 想 删 掉 setArgument 里 面 那些 类 型 转换 操作 [G23] 。 我 想 要 setArgument 
只 简单 地 调用 ArgumentMarshaler ,set。 这 意味 着 我 需要 将 SetIntArg、 setStri 
ngArg 和 setBooleanArg 推 到 合适 的 ArgumentMarshaler 派 生 类 里 面 。 不 过 这 有 个 


问题 。 











仔细 看 setIntArg， 你 会 发 现 ， 它 使 用 了 两 个 实体 变量 : args 和 currentArg。 
为 了 把 setIntArg 移 到 BooleanARgumentMarshaler 里 面 ， 我 得 把 这 两 个 变量 都 作 
为 函数 参数 传递 过 去 。 那 种 做 法 太 烂 了 [F1]。 我 只 想 传 递 一 个 参数 。 幸 运 的 是 ， 有 个 


简单 的 解 





决 方法 




















。 可 以 把 args 数 组 转换 为 一 个 list， 并 向 set 函 数 传递 一 个 Iterato 











r。 这 花 了 我 10 步 功夫 ， 每 次 都 通过 了 测试 。 不 过 我 只 向 你 展示 结果 。 你 应 该 能 看 出 每 


个 小 修改 步骤 。 





public class Args { 
private String schema; 


, 


private boolean valid - true; 
private Set<Character> unexpectedArguments = new TreeSet<Character>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 


private Iterator<String> 


currentArgument; 

private char errorArgumentId = 'N0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode - ErrorCode.OK; 


private List<String> argsList; 


private enum ErrorCode { 
OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED ARGUMENT] 


public Args(String schema, String[] args) throws ParseException { 


this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 
j 
private boolean parse() throws ParseException { 
if (schema.length() -- 0 && argsList.size() 
== 0) 


return true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
j 


return valid; 


j 


private boolean parseArguments() throws ArgsException { 
for (currentArgument - argsList.iterator(); 


currentArgument .hasNext( ) ; 


Qr 
String arg - currentArgument.next(); 
parseArgument(arg); 
} 
retun true; 
} 
private void setIntArg(ArgumentMarshaler m) throws ArgsException { 
String parameter = null; 
try { 


parameter = currentArgument.next 


m.set(parameter); 
} catch (NoSuchElementException 


e) I 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
) catch (ArgsException e) { 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID INTEGER; 
throw e; 
} 
} 


private void setStringArg(ArgumentMarshaler m) throws ArgsException { 


try { 
m.set(currentArgument .next 


()); 


} catch (NoSuchElementException 


e) i 


errorCode - ErrorCode.MISSING STRING; 
throw new ArgsException(); 
j 
} 





| 


是 这 些 简单 的 修改 让 测试 保持 通过 。 现 在 我 们 可 以 开始 把 set 函 数 移植 到 合适 的 派 
生 类 中 了 。 第 一 步 ， 我 要 在 setArgument 中 做 以 下 修改 : 











private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m -- null) 


return false; 


try (1 
if (m instanceof BooleanArgumentMarshaler) 


setBooleanArg(m); 

else if (m instanceof StringArgumentMarshaler ) 
setStringArg(m); 

else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 


) catch (ArgsException e) { 
valid - false; 
errorArgumentId = argChar; 
throw e; 

j 

return true; 


j 














这 个 修改 很 重要 ， 因 为 我 们 想 要 彻底 删除 那 条 if-else 链 。 所 以 ， 需 要 把 错误 条 件 
抽 离 。 


现在 可 以 开始 移动 Set 函数 了 。setBooleanArg 函 数 很 小 ， 就 从 它 开始 。 目 标 是 
ibsetBooleanArgrÉZit H E BooleanArgumentMarshaler/jX. 








private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m -- null) 
return false; 
try ( 


if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m, currentArgument 


) 
else if (m instanceof StringArgumentMarshaler ) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 


setIntArg(m); 

) catch (ArgsException e) { 
valid - false; 
errorArgumentId = argChar; 
throw e; 


j 


return true; 


private void setBooleanArg(ArgumentMarshaler m, 


Iterator<String> currentArgument ) 


throws ArgsException { 
try—t 


m.set("true"); 


eateh—(ArgsException—e)—1 








我 们 不 是 刚 把 那个 异常 处 理 放 进 去 吗 ? 放 进 拿 出 是 重 构 过 程 中 常见 的 事 。 小 步 幅 和 
保持 测试 通过 ， 意 味 着 你 会 不 断 移动 各 种 东西 。 重 构 有 点 像 是 解 魔方 。 需 
步骤 ， 才 能 达到 较 大 目标 。 步 都 是 下 一 步 的 基础 。 












































要 经 过 许多 小 



































为 什么 要 在 setBooleanArg 根 本 不 需要 的 情况 下 向 其 传递 jterator 呢 ?因为 se 


tIntArg 和 setStringArg 需 要 ! 还 因为 我 打算 通过 ArgumentMarshaler 中 的 抽象 
方法 部 署 这 三 个 函数 ， 需 要 将 其 传递 给 setBooleanArg。 





现在 setBooleanArg 没 用 了 。 如 果 ArgumentMarshaler 中 有 个 set 函 数 ， 我 们 
可 以 直接 调用 它 。 是 时 候 打 造 那个 函数 了 ! 第 一 步 ， 在 ArgumentMarshaler 中 添加 抽 
象 方法 








o 


private abstract class ArgumentMarshaler { 
public abstract void set(Iterator<String> currentArgument ) 


throws ArgsException; 


public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 


j 














当然 ， 这 会 影响 到 所 有 派生 类 。 所 以 ， 要 逐个 实现 新 方法 。 








private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
private boolean booleanValue = false; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


booleanValue - true; 


j 
public void set(String s) { 
beeleanValue—-—true; 
j 


public Object get() { 
return booleanValue; 


} 

j 

private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


public void set(String s) { 
stringvalue - s; 


j 


public Object get() { 
return stringValue; 
j 
} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 9; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


public void set(String s) throws ArgsException { 
try { 
intValue - Integer.parseInt(s); 
} catch (NumberFormatException e) { 
throw new ArgsException(); 


j 
} 


public Object get() { 
return intValue; 


} 
} 





现在 可 以 删除 setBoolLeanArg 了 ! 





private boolean setArgument(char argChar) throws ArgsException { 


ArgumentMarshaler m - marshalers.get(argChar); 
if (m -- null) 
return false; 
try ( 
if (m instanceof BooleanArgumentMarshaler) 
m.set 


(currentArgument); 
else if (m instanceof StringArgumentMarshaler ) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
) catch (ArgsException e) { 


valid = false; 
errorArgumentId = argChar; 
throw e; 


} 


return true; 


} 








测试 全 都 通过 ， 而 且 set 函 数 也 部 署 到 BooleanArgumentMarshaler 里 面 了 ! 


























现在 就 能 对 String 和 Integer 参 数 的 处 理 做 同样 的 修改 。 








private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m -- null) 
return false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler ) 
m.set(currentArgument); 


else if (m instanceof IntegerArgumentMarshaler) 
m.set(currentArgument); 


) catch (ArgsException e) ( 


valid - false; 
errorArgumentId = argChar; 
throw e; 
j 
return true; 
ere 
private class StringArgumentMarshaler extends ArgumentMarshaler { 


private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsException { 
try { 


stringValue = currentArgument.next(); 


} catch (NoSuchElementException e) { 


errorCode = ErrorCode.MISSING STRING; 


throw new ArgsException(); 


j 


public void set(String s) { 
j 


public Object get() { 
return stringValue; 


j 
上 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 90; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


String parameter = null; 
try ( 
parameter = currentArgument.next(); 


set(parameter); 


} catch (NoSuchbElementException e) { 


errorCode - ErrorCode.MISSING INTEGER; 


throw new ArgsException(); 


} catch (ArgsException e) { 


errorParameter = parameter; 


errorCode - ErrorCode.INVALID INTEGER; 


throw e; 
} 
j 
public void set(String s) throws ArgsException 
try (1 
intValue = Integer.parseInt(s); 


} catch (NumberFormatException e) { 
throw new ArgsException(); 
} 
j 


public Object get() { 
return intValue; 
} 
} 





最 后 一 击 
: 可 以 移 除 类 型 转换 了 ! 看 招 ! 


private boolean setArgument(char argChar) throws 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m -- null) 
return false; 
try ( 
m.set(currentArgument); 
return true; 


) catch (ArgsException e) { 
valid - false; 
errorArgumentId = argChar; 
throw e; 

j 

$ 


ArgsException 


{ 



































现在 可 以 删 掉 IntegerArgumentMarshaler 中 那些 过 时 的 函数 ， 做 一 下 清理 了 。 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue - 90 


public void set(Iterator<String> currentArgument) throws ArgsException { 
String 
parameter - null; 


try (1 
parameter = currentArgument.next(); 


intValue - Integer.parseInt 


(parameter); 
} catch (NoSuchbElementException e) { 
errorCode - ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 

) catch (NumberFormatException 


e) I 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID INTEGER; 


throw new ArgsException(); 


j 
} 


public Object get() { 
return intValue; 
} 
} 





还 可 以 把 ArgumentMarshaler 修 改 为 接口 。 


private interface 


ArgumentMarshaler { 
void set(Iterator<String> currentArgument) throws ArgsException; 


Object get(); 














现在 来 看 看 往 这 个 结构 中 添加 新 的 参数 类 型 有 多 容易 。 只 需要 做 少量 修改 ， 而 且 修 
改 是 被 隔离 的 。 首 先 ， 增 加 一 个 新 的 测试 用 例 ， 检 测 double 参 数 是 否 正常 工作 。 














public void testSimpleDoublePresent() throws Exception { 
Args args = new Args("x##", new String[] {"-x","42.3"}); 
assertTrue(args.isValid()); 
assertEquals(1, args.cardinality()); 


assertTrue(args.has( 'x')); 
assertEquals(42.3, args.getDouble('x'), .001); 
} 




















然后 清理 范式 解析 代码 ， 为 double 参 数 类 型 添加 ## 监 测 。 











private void parseSchemaElement(String element) throws ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() 


== 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*") 


marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#") 


marshalers.put(elementId, new IntegerArgumentMarshaler()); 


else if (elementTail.equals("##") ) 


marshalers.put(elementId, new DoubleArgumentMarshaler()); 


else 
throw new ParseException(String. format ( 
"Argument: %c has invalid format: %s.", elementId, elementTail), 0); 


Pd 











下 一 步 ， 编 写 DoubleArgumentMarshaler 类 。 

















private class DoubleArgumentMarshaler implements ArgumentMarshaler { 


private double doubleValue = 0; 


public void set(Iterator<String> currentArgument ) 


String parameter = null; 

try { 

parameter = currentArgument.next(); 
doubleValue = Double.parseDouble(parameter ) ; 


} catch (NoSuchElementException e) { 


errorCode = ErrorCode.MISSING_DOUBLE; 


throw new ArgsException(); 


} catch (NumberFormatException e) { 


errorParameter = parameter; 


errorCode = ErrorCode.INVALID_DOUBLE; 


throws ArgsException { 


throw new ArgsException(); 


public Object get() { 


return doubleValue; 








然后 就 得 添加 一 个 新 的 ErrorCode: 


private enum ErrorCode { 
OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED ARGUMENT, 
MISSING DOUBLE, INVALID DOUBLE) 








还 需要 一 个 getDouble 函 数 : 


public double getDouble(char arg) { 


Args.ArgumentMarshaler am = marshalers.get(arg); 


try { 


return am -- null ? 0 : (Double) am.get(); 


) catch (Exception e) { 


return 0.0; 



































全 部 测试 都 通过 了 ! 完全 无 痛 。 再 来 确保 全 部 错误 处 理 代码 正确 工作 。 下 一 个 测试 
用 例 用 来 检测 在 向 ## 参 数 传递 一 个 不 可 解析 的 字符 串 时 是 否 会 返回 错误 。 



































public void testInvalidDouble() throws Exception 

Args args = new Args("x##", new String[] ("-x","Forty two"); 

assertFalse(args.isValid()); 

assertEquals(0, args.cardinality()); 

assertFalse(args.has('x')); 

assertEquals(0, args.getInt('x')); 

assertEquals("Argument -x expects a double but was 'Forty two'.", 
args.errorMessage( )); 


H 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 


throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -%c expects an integer but was '%s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter for -%c.", 
errorArgumentId); 
case INVALID DOUBLE: 


return String.format("Argument -%c expects a double but was '*s'.", 


errorArgumentId, errorParameter); 


case MISSING DOUBLE: 


return String.format("Could not find double parameter for -%c.", 


errorArgumentId); 


j 


return ""; 


j 


























测试 通过 。 下 一 个 测试 确保 我 们 正确 检测 到 遗漏 的 double 参 数 。 














public void testMissingDouble() throws Exception { 


Args args = new Args("x##", new String[]{"-x"}); 


assertFalse(args.isValid()); 


assertEquals(0, args.cardinality()); 


assertFalse(args.has('x')); 


assertEquals(0.0, args.getDouble('x'), 0.01); 


assertEquals("Could not find double parameter for -x." 


args.errorMessage( )); 








测试 如 期 通过 。 我 们 只 是 为 了 保持 一 切 完整 而 编写 这 个 测试 。 





异常 代码 很 丑陋 ， 不 该 在 Args 类 中 存在 。 我 们 也 抛 出 ParseException， 但 那 并 
不 真 的 属于 我 们 自己 。 那 就 把 所 有 异常 都 塞 到 ArgsException 类 中 ， 并 将 其 移 到 它 自 
己 的 模块 里 面 。 




















public class ArgsException extends Exception { 


private char errorArgumentId = '\0'; 


private String errorParameter = "TILT"; 


private ErrorCode errorCode = ErrorCode.OK; 


public ArgsException() {} 


public ArgsException(String message) {super(message) ;} 


public enum ErrorCode { 


OK, MISSING_STRING, MISSING_INTEGER, INVALID_INTEGER, UNEXPECTED_ARGUMENT, 


MISSING_DOUBLE, INVALID_DOUBLE} 


public class Args { 


private char errorArgumentId = 'N0'; 
private String errorParameter = "TILT"; 
private ArgsException. 


ErrorCode errorCode = ArgsException. 


ErrorCode.OK; 
private List<String> argsList; 


public Args(String schema, String[] args) throws 


this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 


j 


private boolean parse() throws ArgsException { 
if (schema.length() -- 0 && argsList.size() -- 
return true; 
parseSchema( ); 


ArgsException 


9) 


try (1 
parseArguments(); 
} catch (ArgsException 


e) i 
} 


return valid; 
} 


private boolean parseSchema() throws ArgsException 


yen 


private void parseSchemaElement(String element) throws ArgsException 


{ 
else 
throw new ArgsException 
( 
String.format("Argument: %c has invalid format: %s.", 
elementId, elementTail) ); 
j 


private void validateSchemaElementId(char elementId) throws ArgsException 


{ 
if (!Character.isLetter(elementId)) { 
throw new ArgsException 
( 
"Bad character:" + elementId + "in Args format: " + schema); 
} 
j 


private void parseElement(char argChar) throws ArgsException 


{ 
if (setArgument(argChar)) 


argsFound.add(argChar); 


else { 
unexpectedArguments.add(argChar); 
errorCode - ArgsException 


.ErrorCode.UNEXPECTED ARGUMENT; 
valid - false; 
} 


j 


private class StringArgumentMarshaler implements ArgumentMarshaler { 
private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


try (1 
stringValue = currentArgument.next(); 
) catch (NoSuchElementException e) { 
errorCode - ArgsException 


.ErrorCode.MISSING STRING; 
throw new ArgsException(); 


} 
} 


public Object get() { 
return stringValue; 


} 
} 


private class IntegerArgumentMarshaler implements ArgumentMarshaler { 
private int intValue - 9; 


public void set(Iterator<String> currentArgument) throws ArgsException 


{ 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 


) catch (NoSuchElementException e) { 
errorCode - ArgsException.ErrorCode.MISSING INTEGER; 
throw new ArgsException 


Q; 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorcode = ArgsException 


.ErrorCode. INVALID INTEGER; 
throw new ArgsException 


public Object get() { 
return intValue; 
} 


j 


private class DoubleArgumentMarshaler implements ArgumentMarshaler { 
private double doubleValue = 0; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


String parameter - null; 

try ( 
parameter = currentArgument.next(); 
doubleValue = Double.parseDouble(parameter); 

) catch (NoSuchbElementException e) { 
errorCode - ArgsException 


.ErrorCode.MISSING DOUBLE; 
throw new ArgsException(); 
) catch (NumberFormatException e) { 
errorParameter - parameter; 
errorCode - ArgsException 


.ErrorCode.INVALID DOUBLE; 
throw new ArgsException(); 


j 
} 


public Object get() { 
return doubleValue; 





很 好 。 现 在 ，Args 抛 出 的 唯一 一 个 异常 是 ArgsException。 把 ArgsException 
移 到 它 自己 的 模块 中 ， 意 味 着 我 们 能 把 大 量 杂 七 杂 八 的 错误 支持 代码 从 Args 模 块 转移 
到 这 个 模块 。 














现在 我 们 完全 把 异常 和 错误 代码 从 Args 模 块 中 隔离 出 来 了 。〔 如 代码 清单 14-13 
一 16 所 示 。) 为 达到 这 一 目标 ， 大 概 做 了 30 次 小 修改 ， 每 次 修改 都 保持 测试 通过 。 


代码 清单 14-13 ArgsTest.java 











package com.objectmentor.utilities.args; 


import junit.framework.TestCase; 


public class ArgsTest extends TestCase 
public void testCreatewithNoSchemaOrArguments() throws Exception { 
Args args - new Args("", new String[0]); 
assertEquals(0, args.cardinality()); 


j 


public void testWithNoSchemaButWithOneArgument() throws Exception { 
try 1 
new Args("", new String[]{"-x"}); 
fail(); 
) catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.UNEXPECTED ARGUMENT, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 


} 
j 
public void testWithNoSchemaButWithMultipleArguments() throws Exception 
try (1 
new Args("", new String[]("-x", "-y"3); 
fail(); 


} catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.UNEXPECTED ARGUMENT, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 


} 
} 


public void testNonLetterSchema() throws Exception { 
try 1 
new Args("*", new String[]{}); 
fail("Args constructor should have thrown exception"); 
) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.INVALID ARGUMENT NAME, 
e.getErrorCode()); 
assertEquals('*', e.getErrorArgumentId()); 
H 
j 


public void testInvalidArgumentFormat() throws Exception { 
try 1 
new Args("f-", new String[]{}); 
fail("Args constructor should have throws exception"); 
) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.INVALID FORMAT, e.getErrorCode()); 
assertEquals('f', e.getErrorArgumentId()); 


j 


public void testSimpleBooleanPresent() throws Exception { 
Args args = new Args("x", new String[]{"-x"}); 
assertEquals(1, args.cardinality()); 
assertEquals(true, args.getBoolean('x')); 


j 


public void testSimpleStringPresent() throws Exception { 
Args args = new Args("x*", new String[]{"-x", "param"}); 
assertEquals(1, args.cardinality()); 
assertTrue(args.has( 'x')); 
assertEquals("param", args.getString('x')); 


j 


public void testMissingStringArgument() throws Exception { 


try (1 
new Args("x*", new String[]{"-x"}); 


fail(); 

) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.MISSING STRING, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 


} 

j 

public void testSpacesInFormat() throws Exception { 
Args args = new Args("x, y", new String[]{"-xy"}); 


assertEquals(2, args.cardinality()); 
assertTrue(args.has('x')); 
assertTrue(args.has('y')); 


j 


public void testSimpleIntPresent() throws Exception { 
Args args = new Args("x#", new String[]{"-x", "42"}); 
assertEquals(1, args.cardinality()); 
assertTrue(args.has('x')); 
assertEquals(42, args.getInt('x')); 


} 
public void testInvalidInteger() throws Exception { 
try (1 
new Args("x#", new String[]{"-x", "Forty two"); 
fail(); 


) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.INVALID INTEGER, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 
assertEquals("Forty two", e.getErrorParameter()); 


H 
j 
public void testMissingInteger() throws Exception { 
try { 
new Args("x#", new String[]{"-x"}); 
fail(); 


) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.MISSING INTEGER, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 


} 

} 

public void testSimpleDoublePresent() throws Exception { 
Args args = new Args("x##", new String[]{"-x", "42.3"}); 


assertEquals(1, args.cardinality()); 
assertTrue(args.has('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 


j 
public void testInvalidDouble() throws Exception { 
try (1 
new Args("x##", new String[]{"-x", "Forty two"); 
fail(); 


) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.INVALID DOUBLE, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 
assertEquals("Forty two", e.getErrorParameter()); 

} 

j 


public void testMissingDouble() throws Exception { 


try (1 
new Args("x##", new String[]{"-x"}); 


fail(); 

) catch (ArgsException e) ( 
assertEquals(ArgsException.ErrorCode.MISSING DOUBLE, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 





代码 清单 14-14 ArgsExceptionTest.java 











public class ArgsExceptionTest extends TestCase { 
public void testUnexpectedMessage() throws Exception { 
ArgsException e - 
new ArgsException(ArgsException.ErrorCode.UNEXPECTED ARGUMENT, 


'x', null); 
assertEquals("Argument -x unexpected.", e.errorMessage()); 
j 
public void testMissingStringMessage() throws Exception { 
ArgsException e - new ArgsException(ArgsException.ErrorCode.MISSING STRING, 


'x', null); 
assertEquals("Could not find string parameter for -x.", e.errorMessage()); 


j 


public void testInvalidIntegerMessage() throws Exception { 
ArgsException e = 
new ArgsException(ArgsException.ErrorCode.INVALID INTEGER, 
'x', "Forty two"); 
assertEquals("Argument -x expects an integer but was 'Forty two'.", 
e.errorMessage( )); 
j 


public void testMissingIntegerMessage() throws Exception { 
ArgsException e - new ArgsException(ArgsException.ErrorCode.MISSING INTEGER, 
'x', null); 
assertEquals("Could not find integer parameter for -x.", e.errorMessage()); 


j 


public void testInvalidDoubleMessage() throws Exception { 
ArgsException e - new ArgsException(ArgsException.ErrorCode.INVALID DOUBLE, 
'x', "Forty two"); 
assertEquals("Argument -x expects a double but was 'Forty two'.", 
e.errorMessage( )); 


j 
public void testMissingDoubleMessage() throws Exception { 
ArgsException e - new ArgsException(ArgsException.ErrorCode.MISSING DOUBLE, 
"x', null); 
assertEquals("Could not find double parameter for -x.", e.errorMessage()); 
} 


} 


Po 


代码 清单 14-15 ArgsException. java 























public class ArgsException extends Exception { 


private char errorArgumentId = '\O'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 


public ArgsException() {} 
public ArgsException(String message) {super(message) ; } 


public ArgsException(ErrorCode errorCode) { 


this.errorCode = errorcode; 

j 

public ArgsException(ErrorCode errorCode, String errorParameter) { 
this.errorCode - errorCode; 
this.errorParameter = errorParameter; 


j 


public ArgsException(ErrorCode errorCode, char errorArgumentIGd, 
String errorParameter) { 


this.errorCode - errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentId; 


j 


public char getErrorArgumentId() { 
return errorArgumentId; 


j 

public void setErrorArgumentId(char errorArgumentId) ( 
this.errorArgumentId = errorArgumentId; 

j 


public String getErrorParameter() { 
return errorParameter; 


j 

public void setErrorParameter(String errorParameter) { 
this.errorParameter = errorParameter; 

j 


public ErrorCode getErrorCode() { 
return errorCode; 


j 

public void setErrorCode(ErrorCode errorCode) { 
this.errorCode - errorCode; 

j 


public String errorMessage() throws Exception { 
switch (errorCode) { 


case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return String.format("Argument -%c unexpected.", errorArgumentId); 
case MISSING STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -%c expects an integer but was '‘'%s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter for -%c.", 
errorArgumentId); 
case INVALID DOUBLE: 
return String.format("Argument -%c expects a double but was  '9*s'.", 
errorArgumentId, errorParameter); 


case MISSING DOUBLE: 
return String.format("Could not find double parameter for -%c.", 
errorArgumentId); 


j 


return ""; 


} 


public enum ErrorCode { 
OK, INVALID FORMAT, UNEXPECTED ARGUMENT, INVALID ARGUMENT NAME, 
MISSING STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE) 





代码 清单 14-16 Args.java 











public class Args { 
private String schema; 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private Iterator<String> currentArgument; 
private List<String> argsList; 


public Args(String schema, String[] args) throws ArgsException { 


this.schema = schema; 
argsList = Arrays.asList(args); 
parse(); 

} 


private void parse() throws ArgsException { 
parseSchema(); 
parseArguments(); 


j 


private boolean parseSchema() throws ArgsException { 


for (String element : schema.split(",")) { 
if (element.length() > 0) { 
parseSchemaElement(element.trim()); 
j 
H 


return true; 


private void parseSchemaElement(String element) throws ArgsException { 
char elementId - element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() -- 90) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#") ) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##") ) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else 
throw new ArgsException(ArgsException.ErrorCode.INVALID FORMAT, 
elementId, elementTail); 


j 


private void validateSchemaElementId(char elementId) throws ArgsException { 
if (!Character.isLetter(elementId)) { 
throw new ArgsException(ArgsException.ErrorCode.INVALID ARGUMENT NAME, 
elementId, null); 


} 
} 
private void parseArguments() throws ArgsException { 
for (currentArgument = argsList.iterator(); currentArgument.hasNext();) { 
String arg = currentArgument.next(); 
parseArgument (arg); 
} 
} 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements(arg); 


j 
private void parseElements(String arg) throws ArgsException ( 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
j 


private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
throw new ArgsException(ArgsException.ErrorCode.UNEXPECTED ARGUMENT, 
argChar, null); 


} 

j 

private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m - marshalers.get(argChar); 


if (m -- null) 


return false; 

try 1 
m.set(currentArgument); 
return true; 

} catch (ArgsException e) ( 
e.setErrorArgumentId(argChar); 
throw e; 

H 

j 


public int cardinality() { 
return argsFound.size(); 


j 


public String usage() { 
if (schema.length() > 0) 


return "-[" + schema + "]"; 
else 
return ""; 
j 
public boolean getBoolean(char arg) { 
ArgumentMarshaler am - marshalers.get(arg); 
boolean b - false; 
try (1 
b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) { 
b - false; 
return b; 
j 
public String getString(char arg) ( 
ArgumentMarshaler am - marshalers.get(arg); 
try (1 
return am == null ? "" : (String) am.get(); 
) catch (ClassCastException e) { 
return ""; 
} 
j 
public int getInt(char arg) { 
ArgumentMarshaler am - marshalers.get(arg); 
try (1 
return am -- null ? 0 : (Integer) am.get(); 
) catch (Exception e) { 
return 0; 
H 
} 
public double getDouble(char arg) ( 
ArgumentMarshaler am - marshalers.get(arg); 
try (1 
return am -- null ? 0 : (Double) am.get(); 


} catch (Exception e) { 
return 0.0; 
} 
j 


public boolean has(char arg) { 
return argsFound.contains(arg); 








对 Args 类 所 做 的 最 主要 的 修改 是 在 监测 部 分 。 从 Args 里 面 取出 了 大 量 代码 ， 放 到 
ArgsException 中 。 很 好 。 我 们 还 把 全 部 ArgumentMarshaler 转 移 到 了 它们 自己 的 
文件 中 。 更 好 ! 








优秀 的 软件 设计 ， 大 都 关乎 分 隔 一 创建 合适 的 空间 放置 不 同 种 类 的 代码 。 对 关注 面 
的 分 隔 让 代码 更 易于 理解 和 维护 。 






































寺 别 有 意思 的 是 ArgsException 中 的 errorMessage 方 法 。 显 然 ， 把 错误 信息 格 
式 化 操作 放 在 Args 里 面 ， 违 反 了 SRP 原 则 。Args 应 该 只 处 理 参 数 ， 不 该 去 管 错 误 信息 
的 格式 。 然 而 ， 把 错误 信息 格式 化 代码 放 到 ArgsException 中 是 否 有 道理 呢 ? 


















































实话 说 ， 这 是 种 折衷 做 法 。 不 打算 用 ArgsException 提 供 的 错误 信息 的 用 户 会 想 
自己 写 错误 信息 。 但 如 果 有 备 好 的 错误 信息 ， 其 方便 之 处 也 并 非 鲜 见 。 




















现在 ， 显 然 我 们 已 经 非常 接近 本 章 开 始 处 所 展示 的 最 终 解决 方案 7 了。 最 后 的 工作 留 
给 你 来 练习 完成 。 














14.4 小 结 


代码 能 工作 还 不 够 。 能 工作 的 代码 经 常会 严重 骨 溃 。 满 足 于 仅仅 让 代码 能 工作 的 程 
序 员 不 够 专业 。 他 们 会 害怕 没 时 间 改 进 代码 的 吉 构 和 设计 ， 我 不 敢 苟 同 。 没 什么 能 比 糟 
嵌 的 代码 给 开发 项 目 促 来 更 深远 和 长 期 的 损 害 了 。 进 度 可 以 重 订 ， 需 求 可 以 重新 定义 ， 
团队 动态 可 以 修正 。 但 糟糕 的 代码 只 是 一 直 腐 败 发 酵 ， 无 情 地 拖 着 团队 的 后 腿 。 我 无 数 
EE CONSTI a re 
己 控 制 。 















































当然 ， 糟 糕 的 代码 可 以 清理 。 不 过 成 本 高 昂 。 随 着 代码 腐败 下 去 ， 模 块 之 间 互 相 渗 
透 ， 出 现 大 量 隐 藏 纠结 的 依赖 关系 。 找 到 和 破除 陈旧 的 依赖 关系 又 费时 间 又 费劲 。 另 一 
方面 ， 保 持 代码 整洁 却 相 对 容易 。 早 晨 在 模块 中 制造 出 一 堆 混 乱 ， 下 午 就 能 轻易 清理 掉 

。 更 好 的 情况 是 ，5 分 钟 之 前 制造 出 混乱 ， 马 上 就 能 很 容易 地 清理 掉 。 









































所 以 ， 解 决 之 道 就 是 保持 代码 持续 整洁 和 简单 。 永 不 让 腐 坏 有 机 会 开始 。 











[1] 
VE: 最 近 我 用 Ruby 语 言 重 写 了 这 个 模块 。 大 概 只 有 Java 版 本 的 1/7 大 小 ， 而 且 结 
构 也 稍 好 一 些 





[2] 
EVE: 即 创 建 一 个 类 型 为 ArgumentMarshaler 的 对 象 实体 。 





[3] 
原 注 : 为 了 避免 这 种 情况 发 生 ， 我 添加 了 一 个 新 的 单元 测试 ， 调 用 所 有 FitNesse 
测试 。 
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精确 ， 实 现 优雅 。 但 它 的 
研判 来 自 JUnit 框 架 的 二 个 
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是 最 有 名 的 Java 框 架 之 一 。 
? 本 





JUnit 
一 样 ， 它 概 
代码 是 怎 


代码 例子 。 


15.1 JUnit 框架 


JUnit 有 很 多 位 作者 ， 但 它 始 于 Kent Beck 和 Eric 
Gamma 一 次 去 亚特兰大 的 飞行 旅程 。Kent 想 学 
Java， 而 Eric 则 打算 学 习 Kent 的 Smalltalk 测 试 框 
架 。“ 对 于 两 个 身 处 狭 罕 空间 的 奇 客 ， 还 有 什么 会 
比 拿 出 笔记 本 电脑 开始 编码 来 得 更 自然 呢 ? Ul ”经 
过 3 小 时 高 海拔 工作 ， 他 们 写 出 了 JUnit 的 基础 代 
f, 








我 们 要 查看 的 模块 ， 是 用 来 帮忙 鉴别 字符 串 比 
较 错误 的 一 段 聪 明代 码 。 访 模块 被 命名 为 
ComparisonCompactor。 对 于 两 个 不 同 的 字符 串 ， 
例如 ABCDE 和 ABXDE， 它 将 用 形 如 <...B[X]D...> 
的 字符 串 来 曝露 两 者 的 不 同 之 处 。 

我 可 以 做 进一步 解释 ， 但 测试 用 例会 更 有 说 服 
力 。 看 看 代码 清单 15-1， 你 将 深入 了 解 到 该 模块 满 
JEM ok. WANS, WH RAMANA. EN 
能 变 得 更 简洁 或 更 明确 吗 ? 


代码 清单 15-1 ComparisonCompactorTest.java 


























package junit.tests.framework; 


import junit.framework.ComparisonCompactor; 


import junit.framework.TestCase; 
public class ComparisonCompactorTest extends TestCase { 


public void testMessage() ( 
String failure- new ComparisonCompactor(0, "b", "c").compact 
("a"); 
assertTrue("a expected:«[b]» but was:<[c]>".equals(failure) ) 


j 


public void testStartSame() ( 
String failure- new ComparisonCompactor(1, "ba", "bc").compa 
ct(null); 
assertEquals("expected:«b[a]» but was:«b[c]»", failure); 


j 


public void testEndSame() ( 
String failure- new ComparisonCompactor(1, "ab", "cb").comp 
act(null); 
assertEquals("expected:«[a]b» but was:«[c]b»", failure); 


j 


public void testSame() { 
String failure- new ComparisonCompactor(1, "ab", "ab").compa 
ct(null); 
assertEquals("expected:«ab» but was:«ab»", failure); 


j 


public void testNoContextStartAndEndSame() ( 
String failure- new ComparisonCompactor(0, "abc", "adc").com 
pact(null); 
assertEquals("expected:«...[b]...» but was:<...[d]...>", fai 
lure); 


public void testStartAndEndContext() { 
String failure- new ComparisonCompactor(1, "abc", "adc").com 
pact(null); 
assertEquals("expected:«a[b]c» but was:«a[d]c»", failure); 


j 


public void testStartAndEndContextWithEllipses() { 
String failure- 
new ComparisonCompactor(1, "abcde", "abfde").compact(null) 


assertEquals("expected:«...b[c]d...» but was:«...b[f]d...»", 
failure); 


5 


public void testComparisonErrorStartSameComplete() { 
String failure= new ComparisonCompactor(2, "ab", "abc").comp 
act(null); 
assertEquals("expected:«ab[]» but was:<ab[c]>", failure); 


j 


public void testComparisonErrorEndSameComplete() { 
String failure- new ComparisonCompactor(0, "bc", "abc").comp 
act(null); 
assertEquals("expected:«[]...» but was:«[a]...»", failure); 


j 


public void testComparisonErrorEndSameCompleteContext() { 
String failure- new ComparisonCompactor(2, "bc", "abc").comp 
act(null); 
assertEquals("expected:«[]bc» but was:«[a]bc»", failure); 


j 


public void testComparisonErrorOverlapingMatches() { 
String failure- new ComparisonCompactor(0, "abc", "abbc").co 
mpact(null); 
assertEquals("expected:«...[]...» but was:«...[b]...»", fail 
ure); 


j 


public void testComparisonErrorOverlapingMatchesContext() { 
String failure- new ComparisonCompactor(2, "abc", "abbc").co 
mpact(null); 
assertEquals("expected:«ab[]c» but was:<ab[b]c>", failure); 


j 


public void testComparisonErrorOverlapingMatches2() { 
String failure- new ComparisonCompactor(0, "abcdde", 
"abcde").compact(null); 
assertEquals("expected:«...[d]...» but was:«...[]...»", fail 
ure); 


public void testComparisonErrorOverlapingMatches2Context() ( 
String failure- 


new ComparisonCompactor(2, "abcdde", "abcde").compact(null 
); 
assertEquals("expected:«...cd[d]e» but was:«...cd[]e»", fail 
ure); 


J 


public void testComparisonErrorWithActualNull() { 
String failure- new ComparisonCompactor(0, "a", null).compac 
t(null); 
assertEquals("expected:«a» but was:«null»", failure); 


j 


public void testComparisonErrorWithActualNullContext() 1 
String failure- new ComparisonCompactor(2, "a", null).compac 
t(null); 
assertEquals("expected:«a» but was:«null»", failure); 


j 


public void testComparisonErrorWithExpectedNull() ( 
String failure- new ComparisonCompactor(0, null, "a").compac 
t(null); 
assertEquals("expected:«null» but was:«a»", failure); 


j 


public void testComparisonErrorWithExpectedNullContext() 1 
String failure- new ComparisonCompactor(2, null, "a").compac 
t(null); 
assertEquals("expected:«null» but was:«a»", failure); 


j 


public void testBug609972() ( 
String failure- new ComparisonCompactor(10, "S&P500", "O").c 
ompact(null); 
assertEquals("expected:«[S&P50]0» but was:<[]0>", failure); 
} 
} 





我 对 用 到 这 些 测 试 的 ComparisonCompactor 进 
4T SARS us 2] Dr. INRIET009678 zz 了 。 每 行 代 





码 、 每 个 让 语句 和 for 循 环 部 被 测试 执行 了。 于 是 我 


对 代码 的 工作 能 力 有 了 极 高 的 信心 ， 也 对 代码 作者 
们 的 技艺 产生 了 极 高 的 碍 敬 。 


ComparisonCompactor 的 代码 如 代码 清单 15-2 所 


——A^ 


人 小。 


代码 清单 15-2 ComparisonCompactor.java《〈 原 始 版 本 ) 





package junit.framework; 


public class ComparisonCompactor { 


private static final String ELLIPSIS = "..."; 
private static final String DELTA END - "]"; 
private static final String DELTA START - = "["; 


private int fContextLength; 
private String fExpected; 
private String fActual; 
private int fPrefix; 
private int fSuffix; 


public ComparisonCompactor(int contextLength, 
String expected, 
String actual) ( 
fContextLength = contextLength; 
fExpected - expected; 
fActual - actual; 


j 


public String compact(String message) { 
if (fExpected == null || fActual == null || areStringsEqual( 
) ) 


return Assert.format(message, fExpected, fActual); 


findCommonPrefix(); 

findCommonSuffix(); 

String expected - compactString(fExpected); 
String actual - compactString(fActual); 

return Assert.format(message, expected, actual); 


j 


private String compactString(String source) ( 
String result = DELTA START + 
source.substring(fPrefix, source.length() 


fSuffix + 1) + DELTA END; 
if (fPrefix » 0) 
result = computeCommonPrefix() + result; 
if (fSuffix » 0) 
result - result * computeCommonSuffix(); 
return result; 


j 


private void findCommonPrefix() { 
fPrefix - 0; 
int end - Math.min(fExpected.length(), fActual.length()); 
for (; fPrefix < end; fprefix++) { 
if (fExpected.charAt(fPrefix) !- fActual.charAt(fPrefix)) 
break; 


j 
j 


private void findCommonSuffix() { 

int expectedSuffix - fExpected.length() - 1; 

int actualSuffix - fActual.length() - 1; 

for (; 
actualSuffix »- fPrefix && expectedSuffix »- fPrefix; 

actualSuffix--, expectedSuffix--) { 
if (fExpected.charAt(expectedSuffix) !- fActual.charAt(act 
ualSuffix)) 

break; 


} 
fSuffix = fExpected.length() - expectedSuffix; 
} 


private String computeCommonPrefix() { 
return (fPrefix > fContextLength ? ELLIPSIS : "") + 
fExpected.substring(Math.max(0, fPrefix - fContextLe 
ngth), 
fPrefix); 
} 


private String computeCommonSuffix() { 
int end = Math.min(fExpected.length() - fSuffix + 1 + fConte 


xtLength, 
fExpected.length()); 
return fExpected.substring(fExpected.length() - fSuffix + 1, 
end) 十 
(fExpected.length() - fSuffix + 1 « fExpected.length( 
) - 


j 


fContextLength ? ELLIPSIS : ""); 


private boolean areStringsEqual() { 
return fExpected.equals(fActual); 
j 
} 





你 可 能 会 对 这 个 模块 有 所 抱 忽 。 里 面 有 些 长 表 





JA ica t eft. _ 如 此 等 等 。 不 过 ， 总 的 
来 说 ， 这 个 模块 很 不 错 。 毕 竟 它 原本 可 能 被 写成 如 
代码 清单 15-3 中 的 样子 。 


代码 清单 15-3 ComparisonCompator.java (AKA) 





package junit.framework; 


public class ComparisonCompactor { 
private int ctxt; 
private String s1; 
private String s2; 
private int pfx; 
private int sfx; 


public ComparisonCompactor(int ctxt, String s1, String s2) { 
this.ctxt - ctxt; 
this.s1 - s1; 
this.s2 - s2; 

} 


public String compact(String msg) { 
if (s1 == null || s2 == null || si.equals(s2)) 


return Assert.format(msg, si, s2); 
pfx = 0; 


for (; pfx < Math.min(si.length(), s2.length()); pfx++) { 
if (s1.charAt(pfx) != s2.charAt(pfx)) 
break; 


} 
int sfx1 = si.length() - 1; 
int sfx2 = s2.length() - 1; 
for (; sfx2 >= pfx && sfxi >= pfx; sfx2--, sfx1--) { 
if (si.charAt(sfx1) !- s2.charAt(sfx2)) 
break; 


sfx = si.length() - sfx1; 

String cmpi = compactString(s1); 
String cmp2 = compactString(s2); 
return Assert.format(msg, cmpi, cmp2); 


j 


private String compactString(String s) ( 

String result - 
"[" + s.substring(pfx, s.length() - sfx + 1) + "J"; 

if (pfx > 0) 
result = (pfx > ctxt ? "..." p "") + 
s1.substring(Math.max(0, pfx - ctxt), pfx) + result; 

if (sfx > 0) ( 
int end = Math.min(si.length() - sfx + 1 + ctxt, si.length 

0); 


result = result + (si.substring(si.length() - sfx + 1, end 


) + 
(si.length() - sfx + 1 < si.length() - ctxt ? "...": " 
DE 
} 
return result; 
} 
} 





即便 作者 们 把 这 个 模 英 写 得 已 经 很 棱 ， 但 重子 
军 军 规 却 告诉 我 们 ， 离 时 要 比 来 时 整洁 。 所 
以 ， 我 们 怎样 才能 改进 代码 清单 15-2 中 的 原始 代码 


NE? 


TH 8 SII x a AE Be PA RNG]. EWS 
的 运行 环境 中 ， 这 类 范围 性 编码 纯 属 多 余 。 所 以 ， 
先 删除 所 有 的 f 前 缀 。 








int contextLength; 
String expected; 
String actual; 


int prefix; 
int suffix; 





下 一 步 ， 在 compact 函 数 开 始 处 ， 有 一 个 未 封 
装 的 条 件 判 断 [G28]。 


public String compact(String message) { 
if (expected -- null || actual -- null || areStringsEqual()) 


return Assert.format(message, expected, actual); 


findCommonPrefix(); 


findCommonSuffix(); 

String expected - compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 





JAP A TERIS DSSS ER ATT SE TER He 


达 代 码 的 意图 。 我 们 拆 解 出 一 个 方法 ， 解 释 这 个 条 
件 判断 。 


public String compact(String message) { 
if (shouldNotCompact() 


) 


return Assert.format(message, expected, actual); 


findCommonPrefix(); 

findCommonSuffix(); 

String expected - compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 


J 


private boolean shouldNotCompact() { 


return expected == null || actual == null || areStringsEqual(); 





我 也 不 太 喜 欢 compact 函 数 中 的 this.expected 和 
this.actual 人 特写。 这 个 是 我 们 把 fxpected 改 为 
expected 时 发 生 的 。 为 什么 函数 中 的 变量 会 与 成 员 
变量 同名 呢 ? 它们 不 是 该 表示 其 他 意思 吗 [N4]? 我 

















们 应 该 区 分 这 些 名 称 。 


String compactExpected 


- compactString(expected 


); 


String compactActual 


- compactString(actual 


); 





否定 式 稍 微 比 肯定 式 难 理解 一 些 [G29]。 我 们 
把 计 语 句 放 到 上 头 ， 调 转 条 件 判 断 。 





public String compact(String message) { 
if (canBeCompacted() 


Jo 


findCommonPrefix(); 

findCommonSuffix(); 

String compactExpected - compactString(expected); 

String compactActual - compactString(actual); 

return Assert.format(message, compactExpected, compactActual 
); 
) else ( 

return Assert.format(message, expected, actual); 
} 
} 


private boolean canBeCompacted( ) 


return expected ! 


- null && 


actual != null && 


!areStringsEqual(); 





pe A 42 {RAT PRINT]. SBE AB HN 
串 ， 但 如 果 canBeCompact 为 false， 它 实际 上 束 不 会 
压缩 字符 捉 。 用 compact 来 俞 名 ， 隐 藏 了 错误 检 碍 
的 副作用 。 注 意 ， 访 函数 返回 一 条 格式 化 后 的 消 
A, MAMMA CaS. AD, RAA 





其 实 应 该 是 formatCompacted Comparison. £ H VA 
下 参数 调用 时 ， 读 起 来 会 好 很 多 : 


public String formatCompactedComparison(String message) { 


两 个 字符 串 是 在 让 语句 体 中 压缩 的 。 我 们 应 当 
拆 分 出 一 个 名 为 compactExpectedAndActual 的 方 
法 。 然 和 而， 我 们 和 希望 formatCompactComparison 函 数 
完成 所 有 的 格式 化 工作 。 而 compact... 函 数 除了 压 





缩 之 外 什么 都 不 做 [G30]。 所 以 ， 做 如 下 拆 分 : 


private String compactExpected; 


private String compactActual; 


public String formatCompactedComparison(String message) { 
if (canBeCompacted()) (1 
compactExpectedAndActual(); 


return Assert.format(message, compactExpected, compactActu 
al); 
) else ( 
return Assert.format(message, expected, actual); 
} 
} 


private void compactExpectedAndActual( ) 


findCommonPrefix(); 

findCommonSuffix(); 

compactExpected - compactString(expected); 
compactActual - compactString(actual); 





注意 ， 这 要 求 我 们 向 成 员 变量 举荐 
compactExpected 和 compactActual。 我 不 喜欢 新 函数 





最 后 两 行 返 回 变量 的 方式 ， 但 前 两 个 可 不 征 这 样 。 
它们 没 采 用 一 以 贯 之 的 约定 [G11]。 我 们 应 该 修改 
findCommonPrefixz 和 findCommonSuffixz， 返 回 前 绥 


AS BE. 








private void compactExpectedAndActual() { 
prefixindex 


= findCommonPrefix(); 
suffixlindex 


= findCommonSuffix(); 
compactExpected - compactString(expected); 
compactActual - compactString(actual); 


Jj 


private int 


findCommonPrefix() { 
int 


prefixIndex 


= 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex 


< end; prefixIndex 


++) { 


if (expected.charAt(prefixIndex 


) != actual.charAt(prefixIndex 


break; 


return prefixIndex; 


j 


private int 


findCommonSuffix() { 

int expectedSuffix - expected.length() - 1; 
int actualSuffix - actual.length() - 1; 

for (; actualSuffix »- prefixIndex 


&& expectedSuffix »- prefixIndex; 
actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) !- actual.charAt(actualS 
uffix)) 
break; 


j 


return 


expected.length() - expectedSuffix; 





我 们 还 应 该 修改 成 员 变 量 的 名 称 ， 使 之 更 准确 
AINI]; HEX. 


仔细 检查 findCommonSuffix， 其 中 藏 了 个 时 序 
VERSA [G31]; 它 依 赖 于 prefixIndex 是 由 








findCommonSuffix 计 算得 来 的 事实 。 如 果 这 两 个 方 
法 不 是 按 这 样 的 顺序 调用 ， 调 试 束 会 变 得 困难 。 为 
了 暴露 这 个 时 序 性 耦合 ， 我 们 将 prefixIndex 做 成 find 
的 参数 。 


private void compactExpectedAndActual() { 
prefixIndex - findCommonPrefix(); 
suffixIndex = findCommonSuffix(prefixlIndex 


); 
compactExpected - compactString(expected); 
compactActual - compactString(actual); 


j 


private int findCommonSuffix(int 


prefixlIndex 


) i 

int expectedSuffix - expected.length() - 1; 

int actualSuffix - actual.length() - 1; 

for (; actualSuffix »- prefixIndex && expectedSuffix »- prefix 
Index; 

actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) !- actual.charAt(actualS 
uffix)) 
break; 

} 

return expected.length() - expectedSuffix; 
} 





我 对 这 样 的 方式 不 太 满 意 。 传 递 prefixIndex 参 
数 有 些 随 意 [G32]。 它 成 功 维持 了 执行 次 序 ， 但 对 


于 解释 排序 的 需要 却 喀 无 作用 。 其 他 程序 员 可 能 会 
ip eno 因为 并 没有 ur XE 
数 确 属 必要 。 还 是 采取 别 的 做 法 吧 。 





private void compactExpectedAndActual() { 
findCommonPrefixAndSuffix 


0; 
compactExpected - compactString(expected); 
compactActual - compactString(actual); 


} 


private void 


findCommonPrefixAndSuffix() 


{ 


findCommonPrefix 


(); 
int expectedSuffix = expected.length() - 1; 


int actualSuffix = actual.length() - 1; 
for (; 
actualSuffix >= prefixIndex && expectedSuffix >= prefixIn 


dex; 
actualSuffix--, expectedSuffix-- 
) i 
if (expected.charAt(expectedSuffix) !- actual.charAt(actualS 
uffix)) 
break; 


suffixIndex - expected.length() - expectedSuffix; 
} 


private void 


findCommonPrefix() { 


prefixIndex = 0; 
int end - Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex++) 


if (expected.charAt(prefixIndex) !- actual.charAt(prefixiInde 
x)) 


break; 


Í 





我 们 恢复 findCommonPreffixz 和 
findCommonSuffix 的 原样 ， 把 findCommonSuffix 的 
名 称 改 为 fndCommonPrefixAndSuffix， 让 它 在 执行 
其 他 操作 之 前 ， 先 调用 findCommonPrefix。 这 样 一 
来 ， 就 以 一 种 相 比 前 种 手段 更 为 有 效 的 方式 建 并 了 
两 个 函数 之 则 的 时 序 关 系 。 





private void findCommonPrefixAndSuffix() ( 
findCommonPrefix(); 
int suffixLength - 1; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) { 
if (charFromEnd(expected, suffixLength) !- 
charFromEnd(actual, suffixLength)) 
break; 


suffixIndex - suffixLength; 


j 


private char charFromEnd(String s, int i) ( 
return s.charAt(s.length()-i); 
} 


private boolean suffixOverlapsPrefix(int suffixLength) { 
return actual.length() - suffixLength « prefixLength || 
expected.length() - suffixLength « prefixLength; 





这 样 束 好 多 了 。 它 暴露 出 suffixIndex 其 实 是 后 
级 的 长 度 ， 而 且 名 字 没 取 好 。 对 于 prefix 也 是 如 
此 。 虽 然 在 那样 一 种 情形 下 index 和 ]ength 是 同 义 
的 ， 但 使 用 length 一 词 却 更 有 一 贯 性 。 问 题 在 于 ， 
suffixIndex 变 量 并 不 从 0 开始 ， 它 从 1 开始 ， 所 以 并 
非 真 正 的 长 度 。 a arn ny 
些 +1 存 在 的 原因 [G33]。 来 修正 它们 吧 。 结 果 就 是 
代码 清单 15-4。 


代码 清单 15-4 ComparisonCompactor.java (过 渡 版 本 ) 





public class ComparisonCompactor { 


private int suffixLength; 


private void findCommonPrefixAndSuffix() ( 
findCommonPrefix(); 
suffixLength 


for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) 
{ 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength) ) 
break; 
} 
} 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i 1 


); 
} 


private boolean suffixOverlapsPrefix(int suffixLength) { 
return actual.length() - suffixLength <= 


prefixLength || 
expected.length() - suffixLength <= 


prefixLength; 
} 


private String compactString(String source) { 
String result = 
DELTA_START + 
source.substring(prefixLength, source.length() - suffixLen 
gth 


) + 
DELTA END; 
if (prefixLength » 0) 
result = computeCommonPrefix() + result; 
if (suffixLength 


> 0) 
result - result * computeCommonSuffix(); 
return result; 


j 


private String computeCommonSuffix() ( 
int end - Math.min(expected.length() - suffixLength 


contextLength, expected.length() 
); 
return 
expected.substring(expected.length() - suffixLength 


, end) + 
(expected.length() - suffixLength 


expected.length() - contextLength ? 
ELLIPSIS : ""); 





我 们 用 charFromEnd 中 的 那个 -1 蔡 代 了 
computeCommonSuffix 中 的 一 堆 +1， 前 者 更 为 合 情 
合理 ，suffixOverlapsPrefix 中 的 两 个 “<=” 操 作 符 也 
同 理 。 这 样 我 们 就 能 修改 suffixIndex 和 suffixLength 
的 名 称 ， 极 大 地 提升 了 代码 的 可 读 性 。 


不 过 还 有 一 个 问题 。 在 消灭 那些 +1 时 ， 我 注意 
到 compactString 中 的 以 下 代码 : 


if (suffixLength > 0) 


看 看 代码 清单 15-4 中 的 这 行 代码 。 因 为 
suffixLength 现 在 要 比 原本 少 1， 我 应 该 把 “>” 操 作 符 
改 为 “>=” 操 作 符 。 那 本 无 道理 ， 不 过 现在 AIA 
X! 这 表示 这 么 做 没 道理 ， 而 且 可 能 是 个 缺陷 。 
虽 ， 也 不 算是 个 缺陷 。 从 之 前 的 分 析 中 我 们 可 以 看 
到 ， 让 语句 现在 会 放置 添加 长 虚 为 零 的 后 缀 。 在 作 
出 修改 之 前 ，i 计 语句 没有 作用 ， 因 为 suffixIndex 永 不 








eT s 


这 说 明 compactString 中 的 两 个 让 语句 都 有 问 
题 ! 看 起 来 它们 都 该 删除 。 所 以 ， 我 们 将 其 注释 
挥 ， 运 行 测试 。 测 试 通过 了 ! 那 束 重新 构 染 
compactString， 删 除 没 用 的 站 语句 ， 将 函数 改 得 更 
加 简洁 [G9]。 





private String compactString(String source) ( 
return 


computeCommonPrefix() + 

DELTA START + 

source.substring(prefixLength, source.length() - suffixLengt 
h) * 


DELTA END + 
computeCommonSuffix(); 


j 





这 样 束 好 多 了 ! 现在 我 们 看 到 ，compactString 
函数 只 是 把 片段 组 合 起 来 。 我 们 甚至 可 以 让 它 更 清 
上 晰 。 有 许多 细微 的 整理 工作 可 做 。 与 其 拖 独 你 遍历 
剩 下 的 那些 修改 ， 我 更 愿意 直接 展示 代码 清单 15-5 
中 的 结果 。 


代码 清单 15-5 ComparisonCompactor.java (最 终 版 ) 











package junit.framework; 


public class ComparisonCompactor { 


private static final String ELLIPSIS = " 


private static final String DELTA END = "]"; 
private static final String DELTA START = "["; 


private int contextLength; 
private String expected; 
private String actual; 
private int prefixLength; 
private int suffixLength; 


public ComparisonCompactor( 
int contextLength, String expected, String actual 
) i 
this.contextLength = contextLength; 
this.expected - expected; 
this.actual - actual; 


j 


public String formatCompactedComparison(String message) { 
String compactExpected - expected; 
String compactActual - actual; 
if (shouldBeCompacted()) { 
findCommonPrefixAndSuffix(); 
compactExpected - compact(expected); 
compactActual - compact(actual); 
} 
return Assert.format(message, compactExpected, compactActual 
); 
} 


private boolean shouldBeCompacted() { 
return !shouldNotBeCompacted( ); 


} 
private boolean shouldNotBeCompacted() { 
return expected == null || 
actual == null || 


expected.equals(actual); 


j 


private void findCommonPrefixAndSuffix() ( 
findCommonPrefix(); 
suffixLength - 0; 
for (; !suffixOverlapsPrefix(); suffixLength++) ( 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength) 


break; 


j 
j 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 


j 


private boolean suffixOverlapsPrefix() { 
return actual.length() - suffixLength «- prefixLength || 
expected.length() - suffixLength «- prefixLength; 


j 


private void findCommonPrefix() { 
prefixLength - 0; 
int end - Math.min(expected.length(), actual.length()); 
for (; prefixLength < end; prefixLength++) 
if (expected.charAt(prefixLength) !- actual.charAt (prefix 
Length)) 
break; 


j 


private String compact(String s) ( 
return new StringBuilder() 
.append(startingEllipsis()) 
.append(startingContext()) 
.append(DELTA START) 
.append(delta(s)) 
.append(DELTA END) 
.append(endingContext()) 
.append(endingEllipsis()) 
.toString(); 

} 


private String startingEllipsis() { 
return prefixLength > contextLength ? ELLIPSIS : ""; 


j 


private String startingContext() ( 
int contextStart - Math.max(0, prefixLength - contextLength) 


int contextEnd - prefixLength; 
return expected.substring(contextStart, contextEnd); 


j 


private String delta(String s) { 
int deltaStart - prefixLength; 
int deltaEnd - s.length() - suffixLength; 
return s.substring(deltaStart, deltaEnd); 


private String endingContext() (1 
int contextStart - expected.length() - suffixLength; 
int contextEnd - 
Math.min(contextStart + contextLength, expected.length()); 
return expected.substring(contextStart, contextEnd); 


j 


private String endingEllipsis() { 
return (suffixLength » contextLength ? ELLIPSIS : ""); 
} 
} 





这 的 确 很 深 有 党 。 模 块 分 解 成 了 一 组 分 析 函 数 和 
一 组 合成 函数 。 它 们 以 一 种 拓扑 方式 排序 ， 每 个 函 
数 的 定义 都 正好 在 其 被 调用 的 位 置 后 面 。 所 有 的 分 
析 孙 数 部 先 出 现 ， 而 所 有 的 合成 函数 部 最 后 出 现 。 


仔细 了 阅读， 你 会 发 现 我 推翻 了 在 本 章 较 前 位 置 
做 出 的 几 个 决定 。 例 如 ， 我 将 几 个 分 解 出 来 的 方法 
重新 内 联 为 formatCompactComparison， 我 修改 了 
souldNotBeCompacted 表 达 式 的 意思 。 这 种 做 法 很 
常见 。 重 构 和 常会 导致 男 一 次 推翻 此 次 重 构 的 重 构 。 
重 构 是 一 种 不 集 试 错 的 迭代 过 程 ， 不 可 避免 地 集中 
于 我 们 认为 是 专业 人 员 该 做 的 事 。 








15.2 ”小结 


如 此 我 们 遵循 了 童子 车 军 规 。 模块 比 我 们 友 现 
它 时 更 整洁 了 。 不 是 说 它 原 本 不 整洁 。 作 者 们 做 了 
早 越 的 工作 。 但 模块 部 能 再 改进 ， 我 们 每 个 人 也 有 
贡 任 把 模块 改进 得 比 友 现时 更 整洁 。 








[1] ” 原 注 : JUnit Pocket Guide , Kent Beck, 
O'Reilly, 2004, P.43. 





[] JRE: WH MAKRY. 


第 16 章 ” 重 构 SerialDate 





如 朱 你 访问 
http://www.jfree.org/jcommon/index.php ， 束 能 找到 
JCommon 类 库 。 深 入 该 类 库 ， 其 中 有 个 名 为 





org.jfree.date 的 程序 包 。 在 该 程序 包 中 ， 有 个 名 为 
SerialDate 的 类 。 我 们 即将 剖析 这 个 类 。 


SerialDate 的 作者 是 David Gilbert。David 显 然 是 


位 经 验 丰富 、 能 为 足够 的 程序 员 。 如 我 们 将 看 到 
的 ， 他 在 代码 中 展示 了 极 高 的 专业 性 和 原则 性 。 无 





论 怎么 说 ， 这 都 是 “好 代码 *。 而 我 将 把 它 据 成 碎 





这 并 非 恶 意 的 行为 。 我 也 不 认为 目 己 比 戴 维 强 
许多 ， 有 权 对 他 的 代码 说 三 道外 。 其 实 ， 如 果 你 看 
过 我 的 代码 ， 我 敢 说 你 也 会 发 现 好 些 该 埋 候 的 东 
西 。 





不 ， 这 也 并 非 做 慢 无 礼 的 行为 。 我 所 要 做 的 ， 
只 是 一 种 专业 眼光 的 检视 ， 不 多 也 不 少 。 那 是 我 们 
祁 该 坦然 接受 的 做 法 。 那 是 我 们 应 该 欢迎 列 人 对 目 
己 做 的 事 。 只 有 通过 这 样 的 批评 ， 我 们 才能 学 到 东 
西 。 医 生 就 是 这 样 做 的 。 飞 行 员 就 是 这 样 做 的 。 律 
get 
B. 


多 说 一 句 关 于 David Gilbert 的 事 : David 不 止 是 
位 优秀 的 程序 员 。 戴 维 有 着 将 代码 免 费 呈 献 给 社区 
的 勇气 和 好 心 。 他 公开 代码 ， 让 所 有 人 都 能 看 到 ， 
邀请 大 众 使 用 并 审查 。 做 得 真 好 ! 


SerialDate〔 见 代码 清单 B-1〉 古 一 个 用 Java 呈 
现 一 个 日 期 的 类 。 为 什么 在 Java 已 经 有 java.util.Date 
和 java.util.Calendar 的 时 候 ， 还 需要 一 个 呈现 日 期 的 
AWE? 作者 编写 这 个 类 ， 是 为 了 啊 应 我 目 己 也 和音 感 
到 的 痛苦 。 在 开放 的 Javadoc (第 67 行 ) 中 ， 他 很 好 

















地 解释 了 原因 。 我 们 可 以 质疑 他 的 初 甫 ， 但 我 的 确 
有 处 理 这 个 问题 的 需要 ， 而 且 我 也 欢迎 有 个 关心 日 
期 其 于 时 间 的 类 存在 。 


16.1 首先 ， 让 它 能 工作 


在 一 个 名 为 SerialDateTests 的 类 (C Wl [C Ru je ER. 
B-2) 中 ， 有 一 些 单元 测试 。 测 试 都 通过 了 。 不 六 
的 是 ， 快 览 一 允 测 试 ， 发 现 它 们 并 没有 测试 所 有 东 
西 [T1]。 例 如 ， 用 “查找 使 用 ”搜索 方法 
MonthCodeToQuarter (2533477) ， 会 发 现 没有 被 
用 过 [F4]。 因 此 ， 单 元 测试 并 没有 测试 这 个 方法 。 


所 以 ， 我 用 Clover 来 检查 单元 测试 敢 新 了 哪些 
代码 。Clover 报 告 说 ， 在 SerialDate 的 185 个 可 执行 
语句 中 ， 单 元 测试 只 执行 了 91 个 〈( 约 50%) [T2]. 
禾 新 图 看 起 来 像 是 一 床 满 是 种 丁 的 析 被 ， 整 个 类 上 
布 满 大 块 的 未 执行 代码 。 


我 的 目标 是 完整 地 理解 和 重 构 这 个 类 。 没 有 好 
得 多 的 测试 履 广 紊 ， 做 不 到 这 个 。 所 以 ， 我 完全 重 
起 炉灶 编写 了 目 己 的 单元 测试 〈 见 代码 清单 B- 

4) 。 


在 阅读 这 些 测 试 时 ， 你 可 以 看 到 ， 其 中 许多 注 
释 挥 了 。 这 些 测试 不 能 通过 。 它 们 代表 了 我 以 为 
SerialDate 应 该 有 的 行为 。 在 我 重 构 SerialDate 时 ， 
也 将 让 这 些 测试 通过 。 
































即便 有 些 测 试 被 注释 挤 ，Clover 还 是 报告 新 的 
单元 测试 执行 了 185 个 可 执行 语句 中 的 170 个 
(92%) 。 这 样 束 好 多 了 ， 而 且 我 想 我 们 可 以 把 这 
个 数字 提高 些 。 


前 几 个 注释 掉 的 测试 〈 第 23 一 63 行 ) 是 我 一 厢 
情愿 。 程 序 并 没有 设计 为 通过 这 些 测 试 ， 但 对 我 来 
说 它们 代表 的 行为 显而易见 [G2]。 我 不 太 确 定 
testWeekdayCodeToString 方 法 为 何 要 写成 那样 ， 不 
过 既然 它 已 经 在 那儿 ， 显 然 不 该 是 区 分 大 小 写 的 。 
编号 这 毕 测 试 大 区 区 小 事 [T3]， 通过 测试 更 加 容 
易 。 我 只 修改 了 第 259 行 和 和 263 行 ， 就 能 使 用 
equalsIgnoreCase 了。 











我 注释 掉 了 第 32 行 和 第 45 行 的 测试 ， 因 为 我 不 
太 明 确 是 否 应 该 文 持 tues 和 thurs 缩 写 。 








第 153 行 和 154 行 的 测试 不 能 通过 。 显 然 ， 它 们 
本 该 通过 [G2]。 我 们 可 以 轻易 地 修正 ， 只 要 对 
stringToMonthCode 作 出 以 下 修改 葡 行 ， 对 于 第 163 
行 和 213 行 的 测试 也 一 样 。 





457 if ((result < || (result > 12)) { 
result = - 
458 for (int i= - 0; i « monthNames.length; i++) 
459 if (s. equalsIgnoreCase(shortNonthNanes[i])) { 
460 result = i+ 1; 
461 break; 


462 } 


463 if (s.equalsignoreCase(monthNames[i])) { 


464 result = i+ 1; 
465 break; 

466 } 

467 } 

468 } 





第 318 行 注释 掉 的 测试 暴露 了 





getFollowingDayOfWeek 方 法 中 的 一 个 缺陷 (第 672 
行 ) 。2004 年 12 月 25 日 是 个 周 六 。 下 一 个 周 六 是 
2005 年 1 月 1 日 。 然 而 ， 运 行 测试 时 ， 会 看 到 
getFollowingDayOfWeelkik [12] 12 H 25 H Z Jr: I] Fi] 7x 
还 是 12 月 25 日 。 显 然 这 不 对 [G3] [T1]。 我 们 看 到 问 
题 在 第 685 行 。 那 是 个 典型 的 边界 条 件 错误 [T5]。 应 
该 是 这 样 : 


685 if (baseDOW >= targetWeekday) { 


很 有 意思 ， 这 个 函数 是 之 前 一 次 修改 的 结果 。 
修改 记录 《第 43 行 ) 显示 ， 
getPreviousDayOfWeek、getFollowingDayOfWeek 和 
getNearestDayOfWweek 中 的 “缺陷 ”已 被 修正 [T6]。 





测试 getrNearestDayOfWeek (第 705 行 ) 的 单元 
测试 testGetNearestDayOfWeek (2532917) 之 前 的 
版 本 不 像 现 在 一 样 没 有 遗漏 。 我 添加 了 大 量 测 试用 


例 ， 因 为 初始 的 测试 用 例 并 没有 全 部 通过 [T6]。 碍 
看 哪些 测试 用 例 被 注释 掉 ， 你 可 以 看 到 失败 的 模 

式 ， 这 很 有 启发。 如果 最 近 的 日 期 是 在 未 来 ， 算 法 
束 会 失败 。 显 然 存 在 某 种 边界 条 件 错误 [T5]。 


Clover 汇 报 的 测试 覆盖 模式 也 很 有 趣 [T8]。 第 
719 行 根本 没有 执行 ! 这 意味 着 第 718 行 的 让 语句 总 
是 得 到 false 的 结果 。 没 错 ， 看 一 眼 代 人 码 就 知道 是 这 
样 。 变 量 adjust 总 是 为 负 ， 所 以 不 会 大 于 或 等 于 4。 
所 以 ， 算 法 错 了 。 


正确 的 算法 如 下 所 示 : 


int delta = targetDOW - base.getDayOfWeek(); 
int positiveDelta = delta + 7; 

int adjust = positiveDelta % 7; 

if (adjust » 3) 














adjust -- 7; 
return SerialDate.addDays(adjust, base); 





最 后 ， 只 要 简单 地 抛 出 
IllegalArgumentException-t ?i$ [fl] Ae A. 
weekInMonthToString 和 relativeToString 返 回 错误 字 
符 串 ， 第 417 行 和 429 行 的 测试 也 能 通过 。 


做 出 这 些 修改 后 ， 所 有 的 单元 测试 都 通过 了 ， 
我 确信 SerialDate 现 下 可 以 工作 。 是 时 候 让 它 “ 做 


mT 


16.2 ”让 它 做 对 


我 们 将 从 头 到 尾 壳 历 SerialDate， 同 时 加 以 改 
进 。 尽 管 在 本 章 的 讨论 中 你 看 不 到 这 个 过 程 ， 在 每 
次 做 修改 后 ， 我 还 是 要 运行 全 部 JCommon 单 元 测 
试 ， 包 括 我 为 SerialDate 改 进 的 那些 单元 测试 。 所 
工作 的 。 


从 第 1 行 开始 ， 我 看 到 大 量 有 关 许 可 、 版 权 、 
作者 和 修改 历史 的 注释 。 我 明白 ， 的 确 有 些 法 律 事 
宜 要 说 明 ， 所 以 版 权 和 许可 信息 应 该 保留 。 另 外 ， 
修改 历史 是 产生 于 19 世 纪 60 年 代 的 古董 ， 现 今 源 代 
D HERI UR 

[C1]. 


从 第 61 行 开始 的 导入 列表 应 该 通过 使 用 
java.text.* 和 和 java.util.* 来 缩短 。[J1] 











Javadoc 的 HTML 格 式 化 工作 (第 67 行 ) SRE 
惧 。 一 个 源 文件 里 面 有 多 种 语言 ， 我 有 点 发 体 。 这 
条 注释 有 4 种 语言 ，Java、 英 文 、Javadoc 利 
html[G1]。 有 那么 多 语言 ， 就 很 难 直 和 帘 了 当 。 例 
如 ， 生 成 Javadoc 后 ， 第 71 行 和 72 行 原本 很 好 的 位 置 
MARKS, Mm AVERSA Bl <ul> A <li> 





样 的 东西 呢 ? 更 好 的 策略 可 能 是 用 <pre> 标 签 把 整 
个 注释 部 分 包围 起 来 ， 这 样 ， 对 于 源 代码 的 格式 化 
只 会 限于 Javadoc 之 内 H , 


第 86 行 是 类 声明 。 这 个 类 为 何 要 命名 为 


SerialDate? Serial 一 词 有 什么 妙 处 吗 ? 是 不 是 因为 
该 类 派生 自 Serializable? 看 来 不 是 这 样 的 。 











别 猜 了 ， 我 知道 为 什么 (或 者 我 认为 自己 知 
道 ) 何以 要 用 Serial 一 词 。 线 索 就 在 位 于 第 98 行 和 
101 行 的 常量 SERIAL LOWER BOUND 和 SERIAL 
UPPER BOUND。 更 好 的 线索 在 从 第 830 行 开始 的 
注释 中 。 访 类 被 命名 为 SerialDate， 是 因为 它 用 “ 序 
列 数 ”(serial number) 来 实现 ， 该 系列 数 恰 好 是 从 
1899 年 12 月 30 日 后 的 天 数 。 


对 此 我 有 两 个 问题 。 首 先 ， 术 语 “ 序 列 数 并 不 
真 对 。 可 能 有 点 诡辩 ， 但 其 呈现 方式 却 更 接近 相对 
偏 移 其 于 序列 数 。 术 语 “ 序 列 数 ”更 多 地 用 于 产品 版 
本 标识 ， 而 非 日 期 标识 。 我 没 发 现 这 个 名 称 特 别 有 
摘 述 力 [N1。 更 有 摘 述 力 的 术语 大 概 是 “ 顺 
FF" CordinaD . 








第 二 个 问题 更 突出 。 名 称 SerialDate 暗 示 了 一 种 
实现 。 该 类 是 个 抽象 尖 。 没 必要 暗示 任何 有 关 实 现 
的 事 。 实 际 上 ， 没 理由 隐藏 实现 ! 我 友 现 这 个 名 称 


放 在 了 不 正确 的 抽象 层级 上 [N2]。 以 我 之 见 ， 该 类 
的 名 称 应 该 山 是 简单 的 Date。 


PEW, Java k £ mA A {Date 
了 ， 上 所 以 这 大 概 也 不 是 最 好 的 名 称 。 因 为 这 个 类 是 
关于 日 期 而 非 时 间 ， 我 想 将 其 命名 为 Day， 但 这 个 
名 字 也 在 多 处 被 滥用 。 最 后 ， 我 选 了 DayDate 作 为 
Ig EDT BT 3E 


从 现在 起 ， 我 将 使 用 术语 DayDate。 请 记 住 ， 
你 读 到 的 代码 清单 ， 还 是 用 的 SerialDate。 


我 理解 为 何 DayDate 继 承 目 Comparable 和 
Serializable. Ai, Atta Ee BAKKE 
MonthConstants¥é? 28MonthConstants 〈 见 代码 清单 
B-3) Re-AWE MS ARN HA TH Ss. Mite 
2B KE Java Y va H3 E] — Pp 4648. PED at 
能 避免 形 如 MonthConstants.January 的 表达 式 ， 不 过 
这 是 个 坏 主 意 [J2]。MonthConstants 其 实 应 该 是 个 极 


o 




















public abstract class DayDate implements Comparable, 
Serializable { 


public static enum Month { 
JANUARY (1), 
FEBRUARY (2), 
MARCH(3), 
APRIL(4), 
MAY(5), 
JUNE(6), 


JULY(7), 
AUGUST(8), 
SEPTEMBER(9), 
OCTOBER(10), 
NOVEMBER(11), 
DECEMBER(12); 


Month(int index) { 
this.index = index; 


j 


public static Month make(int monthIndex) { 
for (Month m : Month.values()) ( 
if (m.index -- monthIndex) 
return m; 


throw new IllegalArgumentException("Invalid month index " 
* monthIndex); 


public final int index; 


j 





把 MonthConstants 改 成 枚 举 ， 导 致 对 DayDate 类 





和 用 到 这 个 类 的 代码 的 一 些 修改 。 我 花 了 一 个 小 时 

来 改 人 代码。 不过， 原来 以 int 为 月 份 类 型 的 函数 ， 现 

在 都 用 上 Month 枚 举 元 素 了。 这 意味 着 我 们 可 以 去 

除 isValidMonthCode 方 法 《第 326 行 ) ， 以 及 

monthCodeToQuarter 等 位 置 的 月 份 代码 错误 检查 
(第 356 行 ) 了 [G5]。 





下 一 步 ， 我 们 看 到 第 91 行 ，serialVersionUID 。 
该 变量 用 于 控制 序列 号 。 如 果 我 们 修改 了 它 ， 用 这 
个 软件 编写 的 旧版 本 DayDate 都 将 不 再 可 用 ， 而 是 
返回 一 个 InvalidClassException 异 常 。 如 果 你 没有 声 


明 serialVersionUID 变 量 ， 则 编译 器 会 上 自动 生成 一 

站， 每 次 修改 模块 时 都 会 得 到 不 一 样 的 值 。 我 知 
道 ， 所 有 的 文档 都 建议 手工 控制 这 个 变量 ， 但 对 我 
来 说 目 动 控制 序列 号 安全 得 多 [G4]。 我 于 此 调试 
InvalidClassException， 也 不 愿意 见 到 如 果 未 记 修改 
serialVersionUID 引 起 的 后 续 工 作 。 所 以 ， 我 要 删除 
这 个 变量 一 至少 暂 时 这 么 做 U 。 


我 友 现 第 93 行 的 注释 是 多 余 的 。 这 正 是 诉 言 和 
误导 信息 所 在 之 地 [C2]。 所 以 我 要 干 挥 它 和 它 的 同 


>< 








第 97 行 和 100 行 的 注释 有 关 序 列 数 ， 我 之 前 已 
经 讨论 过 这 个 问题 [C1]。 它 们 描述 的 变量 是 
DayDate 能 够 描述 的 最 早 和 最 后 的 日 期 。 这 可 以 搞 
得 更 清楚 些 [N11]。 


public static final int EARLIEST DATE ORDINAL = 2; // 1/1/19 
00 
public static final int LATEST DATE ORDINAL - 2958465; // 12/31 


/9999 





我 不 太 清 楚 为 什么 
EARLIEST DATE_ORDINAL 是 2 而 不 是 0。 在 第 
829 行 的 注释 中 有 个 提示 ， 说 明 这 与 用 Microsotft 
Excel 展 示 日 期 的 方式 有 关 。 在 DayDate 的 派生 类 





SpredsheetDate 中 能 看 得 更 深入 《〈 见 代码 清单 B- 
5) 。 和 第 71 行 的 注释 很 好 地 摘 述 了 这 个 问题 。 





我 的 问题 是 ， 这 看 来 应 该 与 SpreadsheetDate 有 
关 ， 与 DayDate 无 关 才 对 。 所 以 ， 
EARLIEST DATE ORDINALZI 
LATEST DATE ORDINAL 实 在 不 该 属于 
DayDate， 应 该 移 到 SpreadSheeDate 中 [G6]。 


的 确 ， 搜 索 一 下 代码 就 知道 ， 这 些 变 量 值 仪 在 
SpreadSheetDate 中 用 到 。DayDate 中 没 用 到 ， 
JCommon 框 架 的 其 他 类 中 也 没有 用 。 所 以 ， 我 将 把 
它们 问 下 移 到 SpreadSheetDate 中 。 


下 面 两 个 变量 ， 
MINIMUN_YEAR_SUPPORTED 和 
MAXIMUM_YEAR_SUPPORTED (第 104 行 和 107 
ÍT) 地 位 是 礁 。 显 然 ， 如 果 DayDate 是 个 没有 提供 
实现 铺垫 的 抽象 类 ， 它 了 怠 不 该 告知 我 们 有 关 最 小 和 
IAE BE. IB. SRI ua $E 
到 SpreadSheetDate 中 [G6]。 然 而 ， 快 速 得 找 这 些 变 
量 的 使 用 情况 ， 会 发 现 另 一 个 类 也 在 用 : 
RelativeDayOfWeekRule《〈 见 代码 清单 B-6) 。 在 第 
177 行 和 178 行 ，getDate 函 数 中 ， 它 们 被 用 来 检查 
getDate 的 年 份 参数 是 否 有 效 。 抽 象 类 的 用 户 需 要 得 
知 其 实现 信息 ， 这 是 个 矛盾 。 


























我 们 要 做 的 是 既 提 供 信 息 ， 又 不 污染 
DayDate。 通 党 ， 我 们 会 从 派生 类 实体 中 获取 实现 
信息 。 不 过 ， 并 未 同 getDate 函 数 传 入 DayDate 的 实 
体 ， 反 而 返回 了 这 么 一 个 实体 。 这 意味 着 必须 在 茶 
处 创建 实体 。 第 187 一 205 行 提供 了 线索 。DayDate 
实体 是 在 getPreviousDayOfWeek、 
getNearestDayOfWeek 或 getFollowingDayOfWeek 这 
三 个 函数 其 中 之 一 里 面 创建 的 。 看 回 DayDate 代 码 
清单 ， 我 们 看 到 ， 这 些 函 数 〈“ 第 638 一 724 行 ) 全 都 
返回 了 由 addDays (第 571 行 ) 创建 的 日 期 实体 ， 
addDays 调 用 CreateInstance (第 808 行 )， 创 建 出 一 
个 SpreadSheetDate! [G7]. 


通常 来 说 ， 基 类 不 宜 了 解 其 派生 类 的 情况 。 为 
了 修正 这 个 毛病 ， 我 们 应 该 利用 抽象 工厂 模式 
(ABSTRACT FACTORY) Dl, ， 创 建 一 个 
DayDateFactory。 访 工厂 将 创建 我 们 所 需要 的 
DayDate 的 实体 ， 并 回答 有 关 实 现 的 问题 ， 例 如 最 
大 和 最 小 日 期 之 类 。 








public abstract class DayDateFactory { 
private static DayDateFactory factory = new SpreadsheetDateFac 
tory(); 
public static void setInstance(DayDateFactory factory) { 
DayDateFactory.factory - factory; 


protected abstract DayDate _makeDate(int ordinal); 

protected abstract DayDate _makeDate(int day, DayDate.Month mo 
nth, int year); 

protected abstract DayDate _makeDate(int day, int month, int y 


ear); 
protected abstract DayDate _makeDate(java.util.Date date); 
protected abstract int _getMinimumYear(); 
protected abstract int  getMaximumYear(); 


public static DayDate makeDate(int ordinal) { 
return factory. makeDate(ordinal); 


j 


public static DayDate makeDate(int day, DayDate.Month month, i 
nt year) { 
return factory. makeDate(day, month, year); 


} 


public static DayDate makeDate(int day, int month, int year) { 
return factory. makeDate(day, month, year); 


j 


public static DayDate makeDate(java.util.Date date) { 
return factory. makeDate(date); 


j 


public static int getMinimumYear() ( 
return factory. getMinimumYear(); 


j 


public static int getMaximumYear() { 
return factory. getMaximumYear(); 
I 
} 





该 工厂 类 用 makeDate 方 法 蔡 代 J 了 createlInstance 
方法 ， 前 者 的 名 称 稍 好 一 些 [IN1]。 在 初始 状态 下 ， 
它 使 用 SpreadsheetDateFactory， 但 随时 可 以 使 用 其 
他 工厂 。 委 托 到 抽象 方法 的 静态 方法 刘 合 采用 了 单 
件 模 式 (SINGLETON) 、 油 洪 工 模式 由 和 抽象 工 
厂 模式 SI， 我 发 现 这 种 手段 很 有 用 。 


SpreadsheetDateFactory 看 起 来 像 这 个 样子 : 


public class SpreadsheetDateFactory extends DayDateFactory ( 
public DayDate _makeDate(int ordinal) { 
return new SpreadsheetDate(ordinal); 


j 


public DayDate _makeDate(int day, DayDate.Month month, int yea 
r) i 
return new SpreadsheetDate(day, month, year); 


j 


public DayDate _makeDate(int day, int month, int year) { 
return new SpreadsheetDate(day, month, year); 


j 


public DayDate _makeDate(Date date) { 
final GregorianCalendar calendar - new GregorianCalendar(); 
calendar.setTime(date); 
return new SpreadsheetDate( 
calendar.get(Calendar.DATE), 
DayDate.Month.make(calendar.get(Calendar.MONTH) + 1), 
calendar.get(Calendar.YEAR)); 
} 


protected int _getMinimumYear() { 
return SpreadsheetDate.MINIMUM YEAR SUPPORTED; 
} 


protected int _getMaximumYear() { 
return SpreadsheetDate.MAXIMUM YEAR SUPPORTED; 
} 
} 





如 你 所 见 ， 我 已 经 把 
MINIMUM YEAR _SUPPORTED 和 和 
MAXIMUM YEAR. _SUPPORTED 变 量 移 到 了 它们 
该 在 的 SpreadsheetDate 中 [G6]。 


DayDate 的 下 一 个 问题 是 第 109 行 的 日 期 常量 。 
这 些 常 量 其 实 应 该 是 枚 举 [J3]。 我 们 之 前 见 过 这 种 
模式 ， 不 再 歼 述 。 你 可 以 在 最 终 的 代码 清单 中 看 
sells 


跟着 ， 我 们 看 到 第 140 行 一 系列 以 
LAST DAY OF MONTH 开 头 的 数组 。 首 先 ， 描 述 
这 些 数 组 的 注释 全 属 多 余 [C3]。 光 看 名 称 就 够 了 。 
所 以 我 要 删除 这 些 注释 。 


这 个 数组 没 理由 不 是 私有 的 [G8]， 因 为 有 个 静 
态 了 水 数 lastDayOfMonth 提 供 同 样 的 数据 。 


下 一 个 数组 
AGGREGATE DAYS TO END OF MONTH E ftf 
秘 一 些 ， 在 JCommon 框 架 中 根本 没 用 到 它 [G9]。 所 
以 我 直接 删除 了 。 


PI 
LEAP YEAR AGGREGATE DAYS TO END OF - 
也 一 样 。 








AGGREGATE DAYS TO END OF PRECEDL 
只 在 SpreadsheetDate 中 用 到 《第 434 行 和 473 行 ) 。 
是 否 把 它 移 到 SpreadsheetDate 中 去 是 个 问题 。 不 转 
移 的 理由 是 ， 该 数组 并 不 专属 于 任何 特定 的 实现 





[G6]。 另 一 方面 ， 实 际 上 并 不 存在 SpreadsheetDate 
之 外 的 实现 ， 所 以 ， 数 组 应 该 移 到 靠近 其 使 用 位 置 
的 地 方 [G10]。 


说 服 我 的 理由 是 保持 一 致 [G11]， 数 组 应 该 私 
有 ， 并 通过 类 似 julianDateOfLastDayOfMonth 这 样 
的 函数 来 骏 露 。 看 来 没 人 需要 那样 的 函数 。 
如 果 有 新 的 DayDate 实 现 需 要 该 数组 ， 可 以 轻易 
把 它 移 回 到 DayDate 中 去 。 所 以 我 束 把 它 移 到 
SpreadsheetDate 里 面 了 。 


对 于 
LEAP YEAR AGGREGATE DAYS TO END OF - 
也 一 样 。 


跟着 ， 我 们 看 到 三 组 可 以 转换 为 枚 举 的 常量 
《第 162 一 205 行 ) 。 第 一 个 用 来 选择 月 份 中 的 一 
周 。 我 将 其 转换 为 名 为 WeekInMonth 的 枚 举 。 








public enum WeekInMonth ( 
FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 
public final int index; 


WeekInMonth(int index) { 
this.index - index; 
} 
} 








第 二 组 常量 〈 第 177 一 187 行 ) 有 点 麻烦 。 
INCLUDE NONE. INCLUDE FIRST. 
INCLUDE SECONDAIINCLUDE BOTH 和 常量 用 于 
摘 述 某 个 范围 的 终止 日 是 否 包 含 在 该 范围 之 内 。 数 
学 上 ， 用 术语 “开放 区 间 ”、“ 半 开放 区 间 ” 和 “闭合 区 
则 ”来 表示 。 我 想 ， 用 数学 术语 来 命名 会 更 清晰 
[N3]， 所 以 束 将 其 转换 为 枚 举 DateInterval， 其 中 包 
括 CLOSED、CLOSED LEFT. CLOSED RIGHT 和 
OPEN 枚 举 元 素 。 


第 三 组 常量 (1820547) 描述 了 是 否 该 在 
最 后 、 下 一 个 或 最 近 的 日 期 实体 中 呈现 对 某 个 星期 
的 特定 一 天 的 查找 结果 。 怎 么 命名 是 个 难题 。 最 
终 ， 我 给 WeekdayRange 设 定 了 LAST、NEXT 和 
NEAREST 枚 举 元 素 。 


你 也 许 不 会 同意 我 取 的 名 字 。 对 我 而 言 这 些 名 
字 有 意义 ， 但 对 你 可 能 就 不 然 。 要 点 是 它们 眼下 变 
成 了 易于 修改 的 形式 [J3]。 不 再 以 整数 形式 传递 ， 
而 是 作为 符号 传递 。 我 可 以 用 IDE 的 “修改 名 称 ” 功 
能 来 改动 名 称 或 类 型 ， 无 需 担 忧 漏 挥 代码 中 某 处 -1 
或 2 之 类 的 数字 ， 也 不 必 担 忧 某 些 int 参 数 声 明 处 于 
描述 不 佳 的 状态 。 


第 208 行 的 描述 字段 看 来 没有 任何 地 方 用 到 。 
我 把 它 及 其 取 值 项 和 赋值 左 都 删 摊 了 。 





























我 还 删除 了 第 213 行 的 默认 构造 器 [G12]。 编 译 
器 会 为 我 们 自动 生成 的 。 


略 过 isValidWeekdayCode 方 法 〈 第 216 一 238 
行 ) ， 在 创建 Day 枚 举 时 已 经 把 它 删 掉 了 。 


于 是 来 到 stringToWeekdayCode 方 法 〈 第 242 一 
270 行 ) 。 没 有 方法 签名 增添 价值 的 Javadoc 都 是 刻 
话 [C3]、[G12]， 唯 一 的 价值 是 对 返回 值 -1 的 描述 。 
然而 ， 因 为 我 们 改 用 了 Day 枚 举 ， 这 条 注释 就 完全 
HIR 了 [C2]。 访 方法 现在 抛 出 一 个 
IllegalArgumentExceptionr #3 o PrUA dM ER J 
Javadoc. 


我 还 删除 了 参数 和 变量 声明 中 的 全 部 final 关 键 
字 。 我 敢 说 ， 它 们 宣 无 价值 ， 空 目 混 请 视听 惑 
[G12]。 删 除 这 些 final， 不 合 某 些 成 例 。 例 如 ， 
Robert Simmons [6] 就 强烈 建议 我 们 “...….…. 在 代码 中 
遍布 final。” 我 不 能 苟同 。 我 认为 ，final 有 少数 的 好 
用 法 ， 例 如 偶尔 使 用 的 final 常 量 ， 但 除 此 之 外 该 关 
键 字 利 小 于 次 。 我 这 么 认为 ， 或 许 是 因为 final 可 能 
I m 早已 被 我 编写 的 单元 测试 
Hak I o 


我 不 喜欢 for 循 环 〈 第 259 行 和 263 行 ) 中 的 那些 
if 语 名 [G5]， 所 以 我 利用 ”操作 符 把 它们 连接 为 时 


个 证 语句 。 我 还 使 用 Day 枚 举 整理 for 循 环 ， 做 了 一 
些 装饰 性 的 修改 。 


我 认为 ， 这 个 方法 并 不 真 属于 DayDate 类 。 它 
其 实 是 Day 的 一 个 解 术 函数。 所以， 我 将 它 移 到 
Day 枚 举 中 。 不 过 ， 那 样 Day 枚 举 残 会 变 得 太 大 。 
因为 Day 的 概念 并 不 依赖 于 DayDate， 我 束 把 Day 榴 
举 移 到 DayDate 类 之 外 ， 放 到 它 目 己 的 源 代码 文件 


o 


我 还 把 下 一 个 函数 ，weekdayCodeToString (第 
272 一 286 行 ) ， 移 植 到 Day 枚 举 中 ， 称 其 为 
toString. 





public enum Day ( 
MONDAY ( Calendar . MONDAY), 
TUESDAY (Calendar.TUESDAY), 
WEDNESDAY (Calendar .WEDNESDAY), s 
THURSDAY (Calendar.THURSDAY), 
FRIDAY(Calendar.FRIDAY), 
SATURDAY (Calendar.SATURDAY), 
SUNDAY (Calendar . SUNDAY ) ; 


public final int index; 
private static DateFormatSymbols dateSymbols = new DateFormatS 
ymbols(); 


Day(int day) { 
index - day; 


j 


public static Day make(int index) throws IllegalArgumentExcept 
ion ( 
for (Day d : Day.values()) 
if (d.index -- index) 


return d; 
throw new IllegalArgumentException( 
String.format("Illegal day index: %d.", index)); 
} 


public static Day parse(String s) throws IllegalArgumentExcept 
ion ( 
String[] shortweekdayNames - 
dateSymbols.getShortWeekdays(); 
String[] weekDayNames - 
dateSymbols.getWeekdays(); 


S = s.trim(); 
for (Day day : Day.values()) { 
if (s.equalsIgnoreCase(shortWeekdayNames[day.index]) || 


s.equalsIgnoreCase(weekDayNames[day.index])) { 
return day; 


} 
} 
throw new IllegalArgumentException( 
String.format("%s is not a valid weekday string", s)); 
} 


public String toString() { 
return dateSymbols.getWeekdays() [index]; 
} 
} 





有 两 个 getMonth 消 数 (第 288 一 316 行 ) 。 
个 函数 调用 第 二 个 函数 。 第 二 个 函数 只 Dre 
数 调用 。 上 所 以 ， 我 把 这 两 个 函数 合 二 为 一 ， 而 且 极 
大 地 简化 之 [G9][G12][F4]。 最 后 ， 我 把 名 称 修改 得 





更 具 目 我 描述 为 [N1]。 





public static String[] getMonthNames() { 
return dateFormatSymbols.getMonths(); 
} 


NEN 


HA f Month 265, eg Zt 
isValidMonthCode〈 第 326 一 346 行 ) 就 变 得 没什么 
用 ， 上 所 以 我 把 它 删 除了 [G9]。 

PK ZtmonthCodeToQuarter. (%356~37547) 有 


特性 依恋 (FEATURE ENVY) [7] 的 味道 ， 可 以 是 
Month 枚 举 中 的 一 个 名 为 quarter 的 方法 ， 我 束 这 人 么 
办 了 。 


public int quarter() { 
return 1 + (index-1)/3; 


这 样 一 来 ，Month 枚 举 束 大 到 需要 放 到 自己 的 
类 中 了 。 我 把 它 从 DayDate 中 移出 来 ， 与 Day 枚 举 保 
持 一 致 [G11][G13]。 





下 两 个 方法 被 命名 为 monthCodeToString (第 
377 一 426 行 ) 。 我 们 再 次 看 到 其 中 一 个 方法 使 用 标 
识 调 用 其 兄弟 方法 的 模式 。 将 标识 作为 参数 传递 给 
函数 的 做 法 通常 不 太 好 ， 尤 其 是 当 访 标识 只 是 有 关 
其 输出 格式 时 [G15]。 我 重 命名 、 简 化、 重新 构架 
了 这 些 函 数 ， 并 把 它们 移 到 Month 枚 举 中 [NT1][N3] 
[G14]. 





public String toString() (1 
return dateFormatSymbols.getMonths()[index - 1]; 


j 


public String toShortString() { 


return dateFormatSymbols.getShortMonths()[index - 1]; 
} 





下 一 个 方法 是 stringToMonthCode 〈 第 428 一 472 
行 ) 。 我 重新 为 它 命 名 ， 转 移 到 Month 枚 举 中 ， 并 
日 简化 之 [N1][N3][C3][G14][G12]。 


public static Month parse(String s) { 
S = s.trim(); 
for (Month m : Month.values()) 
if (m.matches(s)) 
return m; 


try { 
return make(Integer.parseInt(s)); 


catch (NumberFormatException e) {} 


throw new IllegalArgumentException("Invalid month " + s); 


Jj 


private boolean matches(String s) { 
return s.equalsIgnoreCase(toString()) || 
s.equalsIgnoreCase(toShortString()); 





方法 isLeapYear 〈 第 495 一 517 行 ) 可 以 写 得 更 
上 其 表达 力 一 些 [G16]。 


public static boolean isLeapYear(int year) { 


boolean fourth = year % 4 == 0; 

boolean hundredth = year % 100 == 0; 

boolean fourHundredth = year % 400 == 0; 

return fourth && (!hundredth | | fourHundredth); 





下 一 个 函数 leapYearCount (2$519—5361T) FF 
不 真 属于 DayDate。 除 了 SpreadsheetDate 中 的 两 个 方 
法 外 ， 没 有 其 他 调用 者 。 所 以 我 将 它 往 下 放 。 


国 数 lastDayOfMonth《〈 第 538 一 560 行 ) 使 用 了 
LAST DAY OF MONTH 数 组 。 该 数组 应 该 隶属 于 
Month 枚 举 [G17]， 上 所 以 我 束 把 它 移 到 那儿 去 了 。 我 
还 简化 了 这 个 函数 ， 使 其 更 具 表 达 力 [G16]。 





public static int lastDayOfMonth(Month month, int year) ( 
if (month -- Month.FEBRUARY && isLeapYear(year)) 
return month.lastDay() -* 1; 
else 
return month.lastDay(); 


} 





现在 ， 事 情 变 得 比较 有 趣 一 些 了 。 下 一 个 函数 
是 addDays《 第 562 一 576 行 ) 。 首 先 ， FF PAB 
对 DayDate 的 变量 进行 操作 ， 它 就 不 该 是 静态 的 
[G18]。 所 以 ， 我 把 它 修 改 为 实体 方法 。 其 次 ， 它 
调用 了 函数 toSerial。 这 个 冰 数 应 该 重新 命名 为 
toOrdial [IN1]。 最 后 ， 该 方法 可 以 简化 。 














public DayDate addDays(int days) ( 
return DayDateFactory.makeDate(toOrdinal() + days); 


j 





对 于 addMonth 〈 第 578 一 602 行 ) 也 一 样 。 它 应 
该 是 个 实体 方法 [G18]。 算 法 太 过 复杂 ， 上 所 以 我 利 
用 解释 临时 变量 模式 CEXPLAINING 
TEMPORARY VARIABLES) [8l 来 使 其 更 为 透 
明 。 我 还 将 方法 getYYY 重 命名 为 getYear [N1]. 








public DayDate addMonths(int months) { 
int thisMonthAsordinal = 12 * getYear() + getMonth().index - 1 


int resultMonthAsOrdinal = thisMonthAsOrdinal + months; 

int resultYear - resultMonthAsOrdinal / 12; 

Month resultMonth = Month.make(resultMonthAsOrdinal % 12 + 1); 

int lastDayOfResultMonth - lastDayOfMonth(resultMonth, resultY 
ear); 

int resultDay - Math.min(getDayOfMonth(), lastDayOfResultMonth 
); 

return DayDateFactory.makeDate(resultDay, resultMonth, resultY 
ear); 





对 于 函数 addYear (25604-62647) 19H87; 7) 
H. 





public DayDate plusYears(int years) { 

int resultYear = getYear() + years; 

int lastDayOfMonthInResultYear = lastDayOfMonth(getMonth(), re 
sultYear); 

int resultDay - Math.min(getDayOfMonth(), lastDayOfMonthInResu 


ltYear); 
return DayDateFactory.makeDate(resultDay, getMonth(), resultYe 
ar); 


j 





把 这 些 方法 从 静态 方法 变 为 实体 方法 ， 让 我 有 
点 心头 发 痒 。 用 date.addDays(5) 这 样 的 表达 方法 ， 





是 不 是 明确 地 表示 了 date 对 象 并 没 变动 以 及 返回 了 
一 个 DayDate 的 新 实体 呢 ? 或 者 ， 它 只 是 错误 地 暗 
示 我 们 往 date 对 象 添 加 了 5 天 呢 ? 你 可 能 不 会 认为 这 
是 个 大 问题 ， 但 下 列 代码 却 可 能 会 有 欺骗 性 。 


DayDate date = DateFactory.makeDate(5, Month.DECEMBER, 1952); 
date.addDays(7); // bump date by one week. 


有 些 谈 到 这 段 代 码 的 人 会 认为 addDays 在 修改 
date 对 象 。 所 以 ， 我 们 需要 消除 这 种 歧义 的 名 称 
[N4]。 我 把 名 称 改 为 plusDays 和 plusMonths。 我 认 
为 ， 方 法 的 初衷 很 清楚 地 被 


DayDate date = oldDate.plusDays(5); 


所 体现 ， 不 过 下 列 代码 对 认为 date 对 象 被 修改 
的 读者 来 襄 ， 看 起 来 并 不 那么 顺畅 : 


date.plusDays(5); 


算法 越 来 越 有 趣 ，getPreviousDayOfWeek (第 
628—66017) 可 以 工作 ， 不 过 有 点 复杂 了 。 经 过 一 
番 思 考 ， 了 解 到 它 的 功能 后 [G21]， 我 就 能 够 使 用 
解释 临时 变量 模式 来 简化 它 [G19]， 使 其 更 为 清 
蜥 。 我 还 将 它 从 静态 方法 改 为 实体 方法 [G18]， 并 
删除 了 重复 的 实体 方法 [G5]〈 第 997 一 1008 行 ) 。 











public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget - targetDayOfWeek.index - getDayOfWeek().in 
dex; 
if (offsetToTarget »- 0) 
offsetToTarget -- 7; 


return plusDays(offsetToTarget); 
} 





对 getFollowingDayOfWeek 〈 第 662 一 693 行 ) 
也 如 法 炮制 : 


public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget - targetDayOfWeek.index - getDayOfWeek().in 
dex; 
if (offsetToTarget «- 0) 
offsetToTarget += 7; 


return plusDays(offsetToTarget); 
} 





下 一 个 函数 是 我 们 之 前 修改 过 的 
getNearestDayOfWeek 〈 第 695 一 726 行 ) 。 我 之 前 
所 做 的 修改 和 前 两 个 函数 没有 保持 一 致 [G11]。 上 
URR A AIK PA PRIA PRE BC, A HE HRE 
释 临 时 变量 模式 [G19] 来 前 明 算 法 。 


public DayDate getNearestDayOfWeek(final Day targetDay) { 

int offsetToThisweeksTarget = targetDay.index - getDayOfWeek( ) 
.index; 

int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) 96 7; 
int offsetToPreviousTarget - offsetToFutureTarget - 7; 


if (offsetToFutureTarget » 3) 
return plusDays(offsetToPreviousTarget); 
else 
return plusDays(offsetToFutureTarget); 
} 





方法 getEndOfCurrentMonth 〈 第 728 一 740 行 ) 
有 点 奇怪 ， 因 为 它 获 取 了 DayDate 参 数 ， 从 而 成 为 
一 个 依恋 [G14] 其 目 身 类 的 实体 方法 。 我 将 其 改 为 
真正 的 实体 方法 ， 并 修改 了 几 个 名 称 。 








public DayDate getEndOfMonth() { 
Month month = getMonth(); 
int year - getYear(); 
int lastDay - lastDayOfMonth(month, year); 


return DayDateFactory.makeDate(lastDay, month, year); 


j 





重 构 weekInMonthToString〈 第 742 一 761 行 ) 的 
过 程 非常 有 趣 。 利 用 IDE 的 重 构 工具 ， 我 先 将 其 移 
到 我 之 前 创建 的 WeekmMonth 枚 举 中 ， 再 将 其 重 命 
名 为 toString。 跟 看 ， 我 把 它 从 静态 方法 改 为 实体 方 
法 。 所 有 的 测试 都 通过 了 。 “你 能 猜 出 来 我 打算 做 
(FAR? ) 


接 下 来 ， 我 删 挤 了 整个 方法 ! 有 5 个 断言 失败 
了 《第 411 一 415 行 ， 代 码 清单 B-4) 。 我 改动 了 这 
些 代 码 行 ， 让 它们 使 用 枚 举 元 系 的 名 称 (FIRST、 
SECOND......) 。 全 部 测试 都 通过 了 。 你 知道 为 什 
AWG? 你 能 否 知 道 为 什么 这 些 步 又 都 是 必要 的 吗 ? 
重 构 工 具 确 保 之 前 对 weekInMonthToString 方 法 的 调 
用 现在 都 调用 weekImMonth 枚 举 元 素 的 toString 方 
法 ， 全 部 枚 举 元 素 都 以 返回 其 名 称 的 形式 实现 了 
toString YE... 


RARA REHAS o 3X — EOS I RUNI F 
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我 刚 修改 的 测试 ， 所 以 我 删除 了 这 些 测试 。 


所 以 ， 在 判定 除了 测试 之 外 没有 人 调用 过 
relativeToString 〈 第 765 一 781 行 ) 后 ， 我 就 删除 了 
该 函数 及 其 测试 。 




















我 们 最 后 将 其 改 为 这 个 抽象 类 的 抽象 方法 。 第 
一 个 函数 保持 了 原样 : toSerial (第 838 一 844 行 ) 。 
前 文 我 曾 把 名 称 改 为 toOrdinal。 以 现在 的 情形 看 ， 
我 决定 应 该 把 名 称 改 为 getOrdinalDay。 





下 一 个 抽象 方法 是 toDate〈 第 838 一 844 行 ) 。 
它 将 DayDate 转 换 为 java.util.Date。 这 个 方法 为 何 是 
抽象 的 ? 查看 其 在 SpreadsheetDate 中 的 实现 (第 198 
一 207 行 ， 代 码 清单 B-5) ， 可 以 看 到 它 并 不 依赖 于 
该 类 的 实现 [G6]。 所 以 ， 我 把 它 往 上 推 了 。 


方法 getYYYY、getMonth 和 getDayOfMonth 已 
经 是 抽象 方法 。 不 过 ，getDayOfWeek 方 法 是 男 一 个 
应 该 从 SpreadsheetDate 中 提出 来 的 方法 ， 因 为 它 不 
依赖 于 DayDate 之 外 的 东西 [G6]。 是 这 样 吗 ? 


仔细 阅读 (第 247 行 ， 代 人 码 清 蛙 B-5)〉 ， 可 以 发 
现 该 算法 暗中 依赖 于 顺序 日 期 的 起 点 (换言之 ， 第 
0 天 的 星期 日 数 ) 。 所 以 ， 即 便 该 方法 没有 物理 上 
的 依赖 ， 也 不 能 移 到 DayDate 中 ， 因 为 它 的 确 有 逮 
辑 上 的 依赖 。 


这 样 的 逻辑 依赖 困扰 了 我 [G22]。 如 果 有 什么 
东西 在 逻辑 上 依赖 实现 的 话 ， 也 该 有 什么 物理 上 的 
依赖 存在 。 我 也 认为 ， 算 法 本 里 也 该 有 一 小 部 分 依 
赖 于 实现 。 














所 以 我 在 DayDate 中 创建 了 一 个 名 为 
getDayOfWekForOrdinalZero 的 抽象 方法 ， 并 在 
SpreadsheetDate 中 实现 它 ， 返 回 Day.SATURDAY。 
然后 我 把 getDayOfWeek 上 移 到 DayDate 中 ， 并 调用 
getOrdinalDay 和 getDayOf WeekForOrdinal Zero. 


public Day getDayOfWeek() { 
Day startingDay = getDayOfWeekForOrdinalZzero(); 
int startingOffset - startingDay.index - Day.SUNDAY.index; 
return Day.make((getOrdinalDay() + startingOffset) % 7 + 1); 


i 





顺便 说 一 名 ， 请 仔细 阅读 第 895 一 899 行 的 注 
释 。 这 样 的 重复 有 必要 吗 ? GS. JAM RIDE 
FE o 


下 一 个 方法 是 compare (%902~91347) 。 同 
样 ， 该 抽象 方法 是 不 恰当 的 [G6]。 我 将 其 实现 上 移 
到 DayDate。 其 名 称 也 不 足够 有 沟通 意义 [N1]。 方 
法 实际 上 返回 的 是 自 参 数 日 期 以 来 的 天 数 ， 所 以 我 
把 名 称 改 为 daysSince。 我 还 注意 到 该 方 法 没有 测 
试 ， 束 为 它 编 写 了 测试 。 


下 面 6 个 函数 《第 915 一 980 行 ) 全 都 是 应 该 在 
DayDate 中 实现 的 抽象 方法 。 我 把 它们 全 都 从 
SpreadsheetDate 中 抽出 来 了 。 








最 后 一 个 函数 isInRange〈 第 982 一 995 行 ) t% 
要 推 天 上 一 层 并 重 构 之 。 那 个 switch 语 句 有 点 丑陋 
[G23]， 可 以 把 那些 条 件 判断 移 到 DateInterval 枚 举 
"E. 


public enum DatelInterval { 
OPEN { 
public boolean isIn(int d, int left, 
return d » left && d « right; 
} 
ty 
CLOSED_LEFT { 
public boolean isIn(int d, int left, 
return d >= left && d < right; 
} 
ty 
CLOSED_RIGHT { 
public boolean isIn(int d, int left, i right) { 
return d » left && d «- right; 


} 
3 
CLOSED { 
public boolean isIn(int d, int left, 
return d »- left && d «- right; 





H 


public abstract boolean isIn(int d, int left, int right); 


j 


public boolean isInRange(DayDate d1, DayDate d2, DateInterval i 
nterval) ( 
int left = Math.min(di.getOrdinalDay(), d2.getOrdinalDay()); 
int right = Math.max(di.getOrdinalDay(), d2.getOrdinalDay()); 
return interval.isIn(getOrdinalDay(), left, right); 


j 





我 们 来 到 了 DayDate 的 末尾 。 现 在 我 们 要 从 头 
到 尾 再 过 一 次 ， 看 看 整个 重 构 过 程 是 怎样 良好 执行 
的 。 


Be, TIMER OA, RAGS OH SE 
[C2]. 


然后 ， 我 把 全 部 枚 举 移 到 它们 上 自己 的 文件 中 
[G12]. 














跟着 ， 我 把 静态 变量 CdateFormatSymbols) 和 
3 个 静态 方法 (getMonthNames、isLeapYear 和 和 
lastDayOfMonth) 移 到 名 为 DateUtil 的 新 类 中 [G6]。 


我 把 那些 抽象 方法 上 移 到 它们 该 在 的 项 层 类 中 
[G24]. 





我 把 Month.make 改 为 Month.fromInt [IN1]， 并 如 
法 炮制 所 有 其 他 枚 举 。 我 还 为 全 部 枚 举 创 建 了 toInt( 
) 访 问 器 ， 把 index 字 段 改 为 私有 。 


在 plusYears 和 plusMonths 中 存在 一 些 有 趣 的 重 
复 [G5]， 我 通过 抽 离 出 名 为 correctLastDayOfMonth 
的 新 方法 消解 了 重复 ， 使 这 3 个 方法 清晰 多 了 。 


我 消除 了 魔术 数 1[G25]， 用 
Month.JANUARY..toInt( ) 或 Day.SUNDAY .toInt( ) 做 


了 恰当 的 蔡 换 。 我 在 SpreadsheetDate 上 人 花 了 点 时 
间 ， 清 理 了 一 下 算法 。 最 终结 果 在 代码 清单 B-7 一 
16 中 。 


AINE, DayDatel [V 1328 s A EE TIK 到 了 
84.996! 这 并 不 是 因为 测试 到 的 功能 减少 了 ， 而 是 
因为 该 类 缩减 得 太 多 ， 导 致 少量 未 履 凋 到 的 代 但 行 
拥有 了 更 大 权重 。DayDate 的 53 个 可 执行 语句 中 有 
mee ARAS n HART PCI TB SE 
iA 。 











16.3 小结 


我 们 再 一 次 得 从 了 重子 盏 苗 规 。 我 们 俭 入 的 代 
码 ， 要 比 俭 出 时 整洁 了 一 皮 。 虽 然 化 了 后 时 间 ， 不 
过 很 值得 。 测 试 履 蓄 率 提升 了 ， 修 改 了 一 些 缺 陷 ， 
代码 清晰 并 缩短 了 。 后 来 者 有 望 比 我 们 更 容易 地 应 
付 这 些 代 码 。 他 也 有 可 能 把 代码 整理 得 更 干净 些 。 
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Martin Fowler¢t Yb Refectoring:Improving 
the Design of Existing Code 1 中 指出 了 许多 不 同 
的 “代码 味道 >。 下 面 的 清单 包括 很 多 Martin 提 出 的 
味道 ， 还 添加 了 更 多 我 目 己 提出 的 ， 也 包括 我 借以 
历练 本 业 的 其 他 珍宝 与 局 发 。 


我 籍 由 过 响 和 重 构 几 个 不 同 的 程序 总 结 出 这 个 


清单 。 每 次 修改 ， 我 都 问 目 己 为 什么 要 这 样 改 ， 把 
修改 的 原因 写 下 来 。 结 朱 就 是 得 到 相当 长 的 清单 ， 
给 出 在 读 代码 时 让 我 团 起 来 不 舒服 的 味道 。 


消 单 应 按 顺 序 阅 读 ， 并 作为 一 种 参考 来 使 用 。 








17.1 注释 
C1: 不 恰当 的 信息 


题 追 踪 系 统 或 任何 其 他 记录 系统 中 保存 的 信息 ， 

不 恰当 的 。 例 如 ， 修改 历史 记录 只 会 用 大 量 过 时 而 

无 趣 的 文本 搞 乱 源 代码 文件 。 通 常 ， 作 者 、 最 后 修 
改 时 间 、SPR 数 等 元 数据 不 该 在 注释 中 出 现 。 注 释 
只 应 该 描述 有 关 代 码 和 设计 的 技术 性 信息 。 


C2: 废弃 的 注释 

WIN. FCS EWAN TE BATE PE ERE IE 
注释 会 很 快 过 时 。 最 好 别 编写 将 被 废 弃 的 注释 。 如 
果 发 现 废弃 的 注释 ， 最 好 尽快 更 新 或 删除 挤 。 上 废弃 
的 注释 会 远离 它们 曾经 摘 述 的 代码 ， 变 成 代码 中 无 
关 和 误导 的 译 岛 。 
C3: JUR 


如 果 注 释 描 述 的 是 茶 种 充分 目 我 描述 了 的 东 
西 ， 那 么 注释 就 是 多 余 的 。 例 如 : 


i++; // increment i 

















| 


另 一 个 例子 是 除 函 数 签名 之 外 什么 也 没 多 说 
(或 少 说 ) 的 Javadoc: 





fie 
* @param sellRequest 
* @return 
* @throws ManagedComponentException 
* 


/ 
public SellResponse beginSellItem(SellRequest sellRequest) 
throws ManagedComponentException 








注释 应 该 谈 及 代码 目 身 没 提 到 的 东西 。 
C4: FERNE 

值得 编写 的 注释 ， 也 值得 好 好 写 。 如 果 要 编写 
一 条 注释， 就 花 时 间 保 证 写 出 最 好 的 注释 。 字 其 句 
酌 。 使 用 正确 的 语法 和 拼写 。 别 内 扯 ， 别 画 蛇 添 
足 ， 保 持 简 少 。 
C5: 注释 挥 的 代码 

看 到 被 注释 抒 的 代码 会 令 我 抓 狂 。 谁 知道 它 有 
ZH? 谁 知 道 它 有 没有 意义 ? 没 人 会 删除 它 ， 因 为 
大 家 都 假设 别人 需要 它 或 是 有 进一步 计划 。 


那样 的 代码 就 这 样 腐烂 挥 ， 随 看 时 间 推 移 ， 越 














来 越 与 系统 没关系 。 它 调用 不 复 存 在 的 函数 。 它 使 
用 已 改名 的 变量 。 它 遵循 已 被 废弃 的 约定 。 它 污染 
了 所 属 的 模块 ,分散 了 想 要 读 它 的 人 的 注意 力 。 注 
释 挥 的 代码 纯 属 大 物 。 


看 到 注释 挥 的 代码 ， 残 删除 它 ! 别 担心 ， 源 
代码 控制 系统 还 会 记得 它 。 如 果 有 人 真 的 需要 ， 可 
以 签 出 较 前 的 版 本 。 别 个 它 搞 到 死去 活 来 。 











17.2 ”环境 
El. 需要 多 步 才 能 实现 的 构建 


构建 系统 应 该 是 单 步 的 小 操作 。 不 应 该 从 源 代 
人 码 控制 系统 中 一 小 所 一 小 点 签 出 代码 。 不 应 该 需要 
一 系列 神秘 指令 或 环境 依赖 脚本 来 构建 单个 元 素 。 
不 应 该 四 处 寻找 额外 的 小 JAR、XML 文 件 和 其 他 系 
统 所 需 的 杂 物 。 你 应 当 能 够 用 单个 命令 俭 出 系 
统 ， 并 用 单个 指令 构建 它 。 








svn get mySystem 
cd mySystem 
ant all 


E2: 需要 多 步 才 能 做 到 的 测试 


你 应 当 能 够 友 出 单个 指令 就 可 以 运行 全 部 单 
元 测试 。 能 够 运行 全 部 测试 是 如 此 基础 和 重要 ， 应 
该 快速 、 轻 易 和 直截了当 地 做 到 。 


函数 的 参数 量 应 该 少 。 没 参数 最 好 ， 一 个 次 
zo AS, 三 不 同人 次 忆 至 个 以 上 的 参 娄 非常 值 得 
质疑 ， 应 坚决 避免 。《 人 参见 前 文 “ 函 数 参 数 "一 
"qs o 


输出 参数 违反 直觉 。 读 者 期 望 参 数 用 于 输入 而 
非 输出 。 如 果 函 数 非 要 修改 什么 东西 的 状态 不 可 ， 
就 修改 它 所 在 对 象 的 状态 好 了 。 CA WB oc Ha 
参数 ”一 人 。 ) 
F3: 标识 参数 

布尔 值 参数 大 声 宣告 函数 做 了 不 止 一 件 事 。 它 
们 令 人 迷惑 ， 应 该 消灭 挥 。 参见 前 文 “标识 参 
i 
FA: JERZY 


水 不 被 调用 的 方法 应 该 于 和 并。 保留 死 代 码 纯 属 











害怕 删除 E 


FR 


记 住 ， 源 代码 控制 系统 还 


17.4 一 上 般 性 问题 
G1: 一 个 源 文件 中 存在 多 种 语言 


当今 的 现代 编程 环境 允许 在 单个 源 文件 中 存在 
多 种 不 同 语言 。 例 如 ，Java 源 文件 可 能 还 包括 
XML. HTML. YAML, JavaDoc, XX, 
JavaScript 等 语言 。 另 例 ，JSP 文 件 可 能 还 包括 
HTML、Java、 标 签 库 语法 、 英 文 注释 、Javadoc、 
XML、JavaScript 等 。 往 好 处 说 是 令 人 迷惑 ， 往 坏 
处 说 就 是 粗心 大 意 、 驶 杂 不 精 。 


理想 的 源 文件 包括 且 只 包括 一 种 语言 。 现 实 
上 ， 我 们 可 能 会 不 得 不 使 用 多 于 一 种 语言 。 但 应 该 
尽力 减少 源 文 件 中 额外 语言 的 数量 和 范围 。 


G2: 明显 的 行为 未 被 实现 


过 人 循 “ 最 小 惊异 原则 ”(The Principle of Least 
Surprise) |?! ， 函 数 或 类 应 该 实现 其 他 程序 员 有 理 
由 期 每 的 行为 。 例 如 ， 考 虑 一 个 将 日 期 名 称 翻译 为 
表示 该 日 期 的 枚 举 的 函数 。 


Day day = DayDate.StringToDay(String dayName); 

















我 们 期 望 字 符 串 Monday 翻 译 为 
Day.MONDAY 。 我 们 也 期 望 常用 缩写 形式 也 能 被 
翻译 出 来 ， 我 们 还 期 待 函数 忽略 大 小 写 。 


如 果 明 显 的 行为 未 被 实现 ， 读 者 和 用 户 就 不 能 
再 依靠 他 们 对 函数 名 称 的 直 党 。 他 们 不 再 信任 原作 
者 ， 个 得 不 阅读 代 人 码 细 市 。 


G3: 不 正确 的 边界 行为 


代码 应 该 有 正确 行为 ， 这 话 看 似 明日 。 问 题 是 
我 们 很 少 能 明日 正确 行为 有 多 复杂 。 开 及 者 冲冲 与 
出 他 们 以 为 能 工作 的 函数 ， 信 赖 目 己 的 直觉 ， 而 不 
ee 
LiFe 


ATA ATU CEA tl. FIRER BE 
Min Ta. BES Fee ARR I ARTE RI Be tie aL DAE 
而 直上 日 的 算法 的 东西 。 别 依赖 直觉 o 3B SR BER 
界 条 件 ， 并 编写 测试 。 


G4: 忽视 安全 


切 尔 语 贝 利 核电 站 崩塌 了 ， 因 为 电厂 经 理 一 条 
又 一 条 地 忽视 了 安全 机 制 。 齐 守 安 全 就 不 便于 做 试 
验 。 结 束 现 是 试验 未 能 运行 ， 全 世界 都 目 瞳 首 个 氏 
用 核电 站 大 灾难 。 
































忽视 安全 相当 危险。 手工 控制 serialVersionUID 
可 能 有 必要 ， 但 总 会 有 风险 。 关 闭 某 些 编译 器 警告 
《或 者 全 部 警告 ! ) 可 能 有 助 于 构建 成 功 ， 但 也 存 
在 陷于 无 穷 无 尽 的 调试 的 风险 。 关 闭 失 败 测试 、 告 
ES 己 过 后 再 处 理 ， 这 和 假装 刷 信 用 卡 不 用 还 钱 一 
vH. 


G5: 重复 


4 RAS pie SJ] c EW ZZ RD, 
非常 严肃 地 对 等 。 实 际 上 ， 每 位 编写 有 关 软 件 设计 
的 作者 都 提 到 这 条 规则 。Dave Thomas 和 Andy Hunt 
称 之 为 DRY 原 则 (Don’t Repeat Yourself, J)ER H 
ch) Bl, Kent Beck 将 它 列 为 极限 编程 核心 原则 
之 一 ， 并 称 之 为 “一 次 ， 也 只 一 次 ”。Ron Jeffries 将 
这 条 规则 列 在 第 二 位 ， 地 位 只 低 于 通过 所 有 测试 。 


每 次 看 到 重复 代码 ， 部 代表 遗漏 S MWR. ES 

的 代码 可 能 成 为 子 程序 或 干脆 是 为 一 个 类 。 将 重复 

代码 有 登 放 进 类 似 的 抽象 ， 增 加 了 你 的 设计 语言 的 词 

汇 量 。 其 他 程序 员 可 以 用 到 你 创建 的 抽象 设施 。 编 

em 错误 越 来 越 少 ， 因 为 你 提升 了 抽 
ER 


重复 最 明显 的 形态 是 你 不 断 看 到 明显 一 样 的 代 
码 ， 束 像 是 菏 位 程序 员 状 狂 地 用 女 标 不 断 复制 粘贴 






































代码 。 可 以 用 单一 方法 来 普 代 之 。 


较 隐 蔽 的 形态 是 在 不 同 模块 中 不 断 重 复出 现 、 
检测 同一 组 条 件 的 Switchycase 或 ifyelse 链 。 可 以 用 多 
态 来 符 代 之 。 


更 隐 散 的 形态 是 采用 类似 算法 但 具体 代码 行 不 
同 的 模块 。 这 也 是 一 种 重复 ， 可 以 使 用 模板 方法 柑 
X UI giu pus DI 来 修正 。 


的 确 ， 过 去 15 年 内 出 现 的 多 数 设 计 模 式 都 是 消 
除 重 复 的 有 名 手段 。 考 德 范式 〈Codd Normal 
Forms) 是 消除 数据 库 规划 中 的 重复 的 策略 。0OO 自 
刁 也 是 组 织 模块 和 消除 重复 的 策略 。 喀 不 出 奇 ， 结 
构 化 编程 也 是 。 


重点 已 经 在 那里 了 。 尽 可 能 找到 并 消除 重复 。 
G6: 在 错误 的 抽象 层级 上 的 代码 


创建 分 离 较 高 层级 一 般 性 概念 与 较 低 层级 细节 
概念 的 抽象 模型 ， 这 很 重要 。 有 时 ， 我 们 创建 抽象 
类 来 容纳 较 融 层级 概念 ， 创 建 派生 类 来 容纳 较 低 层 
次 概念 。 这 样 做 的 时 候 ， 需 要 确保 分 离 完 整 。 所 有 
较 低层 级 概念 帮 在 派生 类 中 ， 所 有 较 高 层级 概念 
放 在 基 类 中 。 















































例如 ， 只 与 细节 实现 有 天 的 冲 量 、 变 量 或 工具 
函数 不 应 该 在 基 类 中 出 现 。 基 类 应 该 对 这 些 东西 一 
无 所 知 。 


这 条 规则 对 于 源 文 件 、 组 件 和 模块 也 适用 。 展 
好 的 软件 设计 要 求 分 离 位 于 不 同 层级 的 概念 ， 将 它 
们 放 到 不 同 容 磺 中 。 有 时 ， 这 些 容 郁 是 基 类 或 派生 
类 ， 有 时 是 源 文件 、 模 块 或 组 件 。 无 论 哪 种 情况 ， 
分 离 部 要 完整 。 较 低层 级 概念 和 较 局 层级 概念 不 应 
混杂 在 一 起 。 看 看 下 面 的 代码 : 


public interface Stack ( 
Object pop() throws EmptyException; 
void push(Object o) throws FullException; 
double percentFull(); 
class EmptyException extends Exception {} 

















class FullException extends Exception {} 


j 








负数 percentFull 位 于 错误 的 抽象 层级 。 尽 管 存 
在 许多 在 其 中 “充满 ”(fullness) 概念 有 意义 的 Stack 
的 实现 ， 但 也 有 其 他 不 能 知道 目 己 有 多 满 的 实现 
和 存在。 所 以 ， 该 函数 最 好 是 放 在 类 似 BoundedStack 
之 类 的 派生 接口 中 。 


你 或 许 会 认为 ， 如 果 堆 栈 无 边界 ， 实 现 可 以 返 
回 0。 问 题 是 ， 不 存在 真 的 无 边界 的 堆栈 。 你 不 能 
真 的 避免 在 做 以 下 检查 时 出 现 











OutOfMemoryException 7 : 


stack.percentFull() « 50.0. 


SKILI [REO TES ER BAY BEE TE RC UG o 


32 AE VIV B6 BL EB VR JBCEL IU HER T f Us DR 
并 抽象 是 软件 开 友 者 最 难 做 到 的 事 之 一 ， 而 且 一 旦 
做 错 也 没有 快捷 的 修复 手段 。 


G7: 基 类 依赖 于 派生 类 


将 概念 分 解 到 基 类 和 派生 类 的 最 普遍 的 原因 是 
较 高 层级 基 类 概念 可 以 不 依赖 于 较 低 层级 派生 类 概 
念 。 这 样 ， 如 果 看 到 基 类 提 到 派生 类 名 称 ， 就 可 能 
发 现 了 问题 。 通 常 来 说 ， 基 类 对 派生 类 应 该 一 无 所 
知 。 


当然 也 有 例外 。 有 了 时， 派生 类 数量 严格 固定 ， 
而 其 类 中 拥有 在 派生 类 之 间 选 择 的 代码 。 在 有 限 状 
态 机 的 实现 中 这 种 情形 很 多 见 。 然 而 ， 在 那 种 情况 
下 ， 派 生 类 和 基 类 紧密 厢 合 ， 总 是 在 同一 个 jar 文 件 
中 部 署 。 一 般 情 况 下 ， 我 们 会 想 要 把 派生 类 和 其 类 
部 署 到 不 同 的 jar 文 件 中 。 


将 派生 类 和 基 类 部 团 到 不 同 的 jar 文 件 中 ， 确 保 




















基 类 jar 文 件 对 派生 类 jar 文 件 的 内 容 一 无 所 知 ， 我 们 
就 能 把 系统 部 署 为 分 散 和 独立 的 组 件 。 修 改 了 这 些 
组 件 时 ， 不 必 重 新 部 署 基 组 件 就 能 部 署 它们 。 这 意 
味 着 修改 产生 的 影响 极 大 地 降低 了 ， 而 维护 系统 也 
变 得 更 加 简单 。 


G8: 信息 过 多 


设计 民 好 的 模块 有 看 非常 小 的 接口 ， 让 你 能 
半 功 信 。 设 计 低 务 的 模块 有 看 广阔 、 深 入 的 接口 ， 
你 不 得 不 事倍功半 。 设 计 民 好 的 接口 并 不 提供 许多 
需要 依 徘 的 函数 ， 所 以 契合 度 也 较 低 。 设 计 低 务 的 
音 口 提供 大 量 你 必须 调用 的 函数 ， 烛 合 度 较 高 。 


优秀 的 软件 开 友 人 员 学 会 限制 类 或 模块 中 又 露 
的 接口 数量 。 类 中 的 方法 越 少 越 好 。 函 数 知道 的 变 
量 越 少 越 好 。 类 拥有 的 实体 变量 越 少 越 好 。 


隐藏 你 的 数据 。 隐 藏 你 的 工具 函数 。 隐 藏 你 的 
芝 量 和 你 的 临时 变量 。 不 要 创建 拥有 大 量 方 法 或 大 
量 实体 变量 的 类 。 不 要 为 子 类 创建 大 量 受 保护 变量 
Ep "Umm 


G9: JERIB 
死 代 码 就 是 不 执行 的 代码 。 可 以 在 检查 不 会 发 


























生 的 条 件 的 证 语句 体 中 找到 。 可 以 在 从 不 抛 出 异 负 
的 try 语 句 的 catch 块 中 找到 。 可 以 在 从 不 被 调用 的 小 
工具 方法 中 找到 ， 也 可 以 在 永 不 会 发 生 的 
switch/case 条 件 中 找到 。 


死 代码 的 问题 是 过 不 久 它 融会 发 出 具 味 。 时 间 
越 入 ， 味 道贺 越 酸 具 。 这 和 是 因为 ， 在 设计 改变 时 ， 
死 代码 不 会 随 之 更 新 。 它 还 能 通过 编译 ， 但 并 不 
会 遵循 较 新 的 约定 或 规则 。 它 编写 的 时 候 ， 系 统 是 
HEIRE 。 如 条 你 找到 死 代 码 ， 就 体面 地 埋葬 
它 ， 将 它 从 系统 中 删除 挥 。 


G10: # B75 


变量 和 函数 应 该 在 靠近 被 使 用 的 地 方 定 义 。 本 
地 变量 应 该 正好 在 其 首次 被 使 用 的 位 置 上 面 声明 ， 
垂直 距离 要 短 。 本 地 变量 不 该 在 其 被 使 用 之 处 几 百 
行 以 外 声明 。 

私有 函数 应 该 刚好 在 其 首次 被 使 用 的 位 置 下 面 
定义 。 私 有 函数 属于 整个 类 ， 但 我 们 还 是 要 限制 调 
用 和 定义 之 间 的 垂直 距离 。 找 个 私有 洱 数 ， 应 该 只 
是 从 其 首次 被 使 用 处 往 下 看 一 点 那么 简单 。 
G11: 前 后 不 一 致 


从 一 而 终 。 这 可 以 退 调 到 最 小 怀 异 原则 。 小 心 























选择 约定 ， 一 旦 选中 ， 就 小 心 持续 讲 循 。 


如 果 在 特定 函数 中 用 名 为 response 的 变量 来 持 
有 HttpServletResponse 对 象 ， 则 在 其 他 用 到 
HttpServletResponse 对 象 的 印 数 中 也 用 同样 的 变量 
名 。 如 采 将 茶 个 方法 命名 为 
processVerificationRequest， 则 给 处 理 其 他 请 求 类 型 
的 方法 取 类 似 的 名 字 ， 例 如 


processDeletionRequest. 


如 此 简单 的 前 后 一 致 ， 一 旦 坚决 贯彻 ， 就 能 让 
代码 更 加 易于 阅读 和 修改 。 


G12: 混 消 视听 


没有 实现 的 默认 构造 右 有 何 用 处 呢 ? 它 只 会 用 
无 意义 的 淋 雄 搞 乱 对 代码 的 理解 。 没 有 用 a 到 的 变 
量 ， 从 不 调用 的 函数 ， 没 有 信息 量 的 注释 ， 等 等 ， 
这 些 痢 是 应 该 移 除 的 废物 。 保 持 源 文件 整洁 ， 民 好 
地 组 织 ， 不 被 搞 乱 。 


G13: 人 为 耦合 


不 互相 依赖 的 东西 不 该 磷 合 。 例 如 ， 普 通 的 
enum 不 应 在 特殊 关中 包括 ， 因 为 这 样 一 来 应 用 程序 
就 妥 了 解 这 些 更 为 特殊 的 类 。 对 于 在 特殊 类 中 声明 
一 般 目的 的 static 函 数 也 是 如 此 。 
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恰当 地 放 在 临时 方便 的 位 置 。 这 是 补 漫不经心 的 从 
WT. 


化 点 时 间 研 究 应 该 在 什么 地 方 声明 函数 、 
和 变量 。 不 要 为 了 方便 随手 放置 ， 然 后 置 之 不 m. 


G14: 特性 依恋 











这 是 Martin Fowler 提 出 的 代码 味道 之 一 中 。 类 
的 方法 只 应 对 其 所 属 类 中 的 变量 和 函数 感 兴趣 ， 不 
该 垂青 其 他 类 中 的 变量 和 函数 。 当 方法 通过 某 个 其 
他 对 象 的 访问 器 和 修改 占 来 操作 该 对 象 内 部 数据 ， 
WE AKT 该 对 象 所 属 类 的 范围 。 它 期 望 目 己 
在 那个 类 里 面 ， 这 样 就 能 直接 访问 它 操作 的 变量 。 
例如 : 


public class HourlyPayCalculator { 
public Money calculateweeklyPay(HourlyEmployee e) { 
int tenthRate = e.getTenthRate().getPennies(); 
int tenthswWorked = e.getTenthsWorked(); 
int straightTime = Math.min(400, tenthsWorked); 
int overTime - Math.max(0, tenthsWorked - straightTime); 
int straightPay - straightTime * tenthRate; 




















int overtimePay - (int)Math.round(overTime*tenthRate*1.5); 
return new Money(straightPay + overtimePay); 





方法 calculateWeeklyPay 伸 手 到 HourlyEmployee 
对 象 ， 获 取 要 操作 的 数据 。 方 法 calculateWeeklyPay 
依恋 于 HourlyEmployee 的 作用 范围 。 它 “期 望 " 自 己 
在 HourlyEmployee 中 。 


同样 情况 下 ， 我 们 要 消除 特性 依恋 ， 因 为 它 将 
一 个 类 的 内 部 情形 骏 露 给 了 万 外 一 个 类 ,不 过 ， 有 
时 特性 依恋 是 种 有 必要 的 亚 行 。 看 下 面 的 代码 ; 








public class HourlyEmployeeReport { 
private HourlyEmployee employee ; 


public HourlyEmployeeReport(HourlyEmployee e) { 
this.employee - e; 


j 


String reportHours() { 
return String.format( 
"Name: %s\tHours:%d.%1d\n", 
employee.getName(), 
employee.getTenthsworked()/10, 


employee.getTenthsWorked( )%10) ; 





显然 ，reportHours 方 法 依恋 于 HourlyEmployee 
类 。 男 一 方面 ， 我 们 并 不 想 要 HourlyEmployee 得 知 
报告 的 格式 。 把 格式 化 字符 串 移 人 到 HourlyEmployee 
会 破坏 好 几 种 面向 对 象 设计 原则 UI. rec 
E i HUGE. IH 
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G15: 选择 算 子 参数 


没有 什么 比 在 函数 调用 末尾 遇 到 一 个 false 参 数 
更 为 可 民 的 事情 了 。 那 个 false 是 什么 意思 ? WREE 
是 true， 会 有 什么 变化 吗 ? 不 仅 是 一 个 选择 算 子 
(selector) 参数 的 目的 难以 记 住 ， 每 个 选择 算 子 参 
数 将 多 个 函数 绑 到 了 一 起 。 选 择 算 子 参数 只 是 一 种 
避免 把 大 函数 切 分 为 多 个 小 函数 的 偷懒 做 法 。 考 虑 
下 面 这 段 代码 : 





public int calculateWeeklyPay(boolean overtime) { 
int tenthRate - getTenthRate(); 
int tenthsWorked = getTenthsWorked(); 
int straightTime = Math.min(400, tenthsWorked); 
int overTime - Math.max(0, tenthsWorked - straightTime); 
int straightPay - straightTime * tenthRate; 


double overtimeRate - overtime ? 1.5 : 1.0 * tenthRate; 
int overtimePay - (int)Math.round(overTime*overtimeRate); 
return straightPay + overtimePay; 
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这 个 函数 ，false 则 表示 直接 计算 。 每 次 用 到 这 个 函 
数 ， 你 都 得 记 住 calculatewWeeklyPay(false) 表 示 什 
么 ， 这 已 经 足够 糟糕 了 了 。 但 这 种 函数 真正 的 坏处 在 
于 作者 错过 了 这 样 写 的 机 会 : 
public int straightPay() (1 


return getTenthsWorked() * getTenthRate(); 
} 








public int overTimePay() { 
int overTimeTenths = Math.max(0, getTenthsWworked() - 400); 
int overTimePay - overTimeBonus(overTimeTenths); 
return straightPay() + overTimePay; 


j 


private int overTimeBonus(int overTimeTenths) { 
double bonus - 0.5 * getTenthRate() * overTimeTenths; 
return (int) Math.round(bonus); 


j 





当然 ， 选 择 算 子 不 一 定 是 boolean 类 型 。 可 能 是 
枚 举 元 素 、 整 数 或 任何 一 种 用 于 选择 函数 行为 的 参 
数 。 使 用 多 个 水 数 ， 通 党 优 于 问 单 个 函数 传递 某 些 
代码 来 选择 函数 行为 。 


G16: HEX E 


代码 要 尽 可 能 具有 表达 力 。 联 排 表 达 式 、 匈 政 
利 语 标记 法 和 魔术 数 都 遮 藤 了 作者 的 意图 。 例 如 ， 
下 面 是 overTimePay 函 数 可 能 的 一 种 表现 形式 : 


public int m otCalc() ( 
return iThsWkd * iThsRte + 
(int) Math.round(0.5 * iThsRte * 


Math.max(0, iThsWwkd - 400) 
); 
} 
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时 间 将 代码 的 意图 呈现 给 读者 。 
G17: 位 置 错 误 的 权 责 

软件 开发 者 做 出 的 最 重要 决定 之 一 就 是 在 哪里 
BURNS. PION, PrE SE Ab? 是 该 在 Math 类 中 


H3? 或 者 应 该 属于 Trigonometry 类 ? 还 是 在 Circle 
3 2 
* 











最 小 惊异 原则 在 这 里 起 作用 了 。 代 码 应 该 放 在 
读者 自然 而 然 期 待 它 所 在 的 地 方 。PI 常 量 应 该 在 出 
FL TE Fa BA = fA HT. OVERTIME RATE? Æ 
应 该 在 HourlyPayCalculator 类 中 声明 。 


有 了 时， 我 们 “了 乳 明 ”地 知道 在 何 处 放置 功能 代 
码 。 我 们 会 放 在 目 己 方便 而 读者 不 能 随 直 觉 找 到 的 
地 方 。 例 如 ， 也 许 我 们 需要 打印 出 东 个 屠 员 的 总 工 
作 时 间 的 报表 。 我 们 可 以 在 打印 报表 的 代码 中 做 工 
作 时 间 统 计 ， 或 者 我 们 可 以 在 接受 工作 时 间 卡 的 代 
码 中 保留 一 份 工作 时 间 记 录 。 


(LIX SR FE AIR EZ EARMA. EU, 
报表 模块 有 个 名 为 getTotalHours 的 函数 。 接 受 时 间 
卡 的 模块 有 一 个 saveTimeCard 函 数 。 顾 名 思 义 ， 哪 
个 名 称 上 暗示 了 函数 会 计算 总 时 间 呢 ? 答案 显 而 易 
见 。 




















显然 ， 对 于 总 时 间 应 该 在 接受 时 间 卡 的 时 候 计 
算 而 不 是 在 打印 报表 时 计算 ， 这 里 面 有 些 性 能 上 的 
考量 。 没 问题 ， 但 函数 名 称 应 该 反映 这 种 考虑 。 例 
如 ， 应 该 在 时 间 卡 模块 中 有 个 
computeRunningTotalOfHours PF 2X . 


G18: 不 恰当 的 静态 方法 


Math.max(double a, double) 是 个 民 好 的 静态 方 
法 。 它 并 不 在 单个 实体 上 操作 ; 的 确 ， 不 得 不 与 
new Math( ).max(a,b) H} #a.max(b)3£7E Rik. AS 
max 用 到 的 全 部 数据 来 自 其 两 个 参数 ， 而 不 是 来 
目 “ 所 属 ” 对 象 。 而 且 ， 我 们 也 没 机 会 用 到 Math.max 
的 多 态 特 征 。 


不 过 ， 我 们 有 时 也 编写 不 该 是 静态 的 静态 方 
ik. Wu 


HourlyPayCalculator.calculatePay(employee, overtimeRate). 


这 看 起 来 像 是 个 有 道理 的 static 函 数 。 它 并 不 在 
任何 特定 对 象 上 操作 ， 而 且 从 参数 中 获得 全 部 数 
据 。 然 而 ， 我 们 却 有 理由 和 希望 这 个 函数 是 多 态 的 。 
我 们 可 能 希望 为 计算 每 小 时 文 付 工资 实现 几 种 不 同 
算法 ， 例 如 OvertimeHourlyPayCalculator 和 






































StraightTimeHourlyPayCalculator。 所 以 ， 在 这 种 情 
况 下 ， 该 函数 束 不 该 是 静态 的 。 它 该 是 Employee 的 
非 静 态 成 员 函 数 。 


通 第 应 该 倾 同 于 选用 非 静 态 方 法 。 如 果 有 疑 
问 ， 束 是 用 非 静 态 函 数 。 如 末 的 确 需 要 静态 函数 ， 
确 你 没 机 会 打算 让 它 有 多 态 行 为 。 


G19: 使 用 解释 性 变量 


Kent Beckft KE: x Smalltalk Best Practice 
Patterns 19] $55 — #45 E Implementation Patterns 
(中 译 版 《实现 模式 》) DPlepapespx4. ibfe 
序 可 读 的 最 有 力 方法 之 一 束 是 将 计算 过 程 打 散 成 在 
用 有 意义 的 单词 命名 的 变量 中 放置 的 中 间 值 。 


看 看 来 自 FitNesse 的 这 个 例子 : 


Matcher match = headerPattern.matcher(line); 
if(match.find()) 























String key - match.group(1); 
String value - match.group(2); 


headers.put(key.toLowerCase(), value); 


j 





解释 性 变量 的 这 种 徐 单 用 法 ， 说 明了 第 一 个 匹 
配 组 是 key， 而 第 二 个 匹配 组 是 value。 


这 事 很 难 做 过 火 。 解 释 性 变量 多 比 少 好 。 只 要 
把 计算 过 程 打 散 成 一 系列 民 好 命名 的 中 间 值 ， 不 透 
明 的 模块 就 会 突然 变 得 透明 ， 这 很 值得 注意 。 


G20: 函数 名 称 应 该 表达 其 行为 


看 看 这 行 代码 : 


Date newDate = date.add(5); 


你 会 期 望 它 同日 期 添加 5 天 吗 ? 或 者 是 5 个 星 
期 ? 5 个 小 时 ? 该 date 实 体会 变化 吗 ? 或 者 该 函数 只 
是 返回 一 个 新 的 Date 实 体 ， 并 不 改动 旧 的 ?从 函数 
调用 中 看 不 出 函数 的 行为 。 


如 果 函 数 向 日 期 添加 5 天 并 且 修 改 该 日 期 ， 就 
该 命名 为 addDaysTo 或 increaseByDays。 如 果 函 数 返 
回 一 个 表示 5 天 后 的 日 期 ， 而 不 修改 日 期 实体 ， 丈 
该 叫做 daysLater 或 daysSince。 


如 果 你 必须 查看 函数 的 实现 或 文档 ) 才 知道 
它 是 做 什么 的 ， 融 该 换个 更 好 的 函数 名 ， 或 者 重新 
安排 功能 代码 ， 放 到 有 较 好 名 称 的 函数 中 。 


G21: 理解 算法 














好 多 可 笑 代 人 码 的 出 现 ， 是 因为 人 们 没 伦 时 间 去 
理解 算法 。 他 们 硬 赛 进 足够 多 的 让 语句 和 标识 ， 从 
Aa o 





编程 常常 是 一 种 探险 。 你 以 为 自己 知道 某 事 
的 正确 算法 ， 然 后 束 包 起 袖子 瞎 干 一 气 ， 搞 到 “可 
以 工作 ”为 止 。 你 怎么 知道 它 “ 可 以 工作 ”? 因为 它 
通过 了 你 能 想到 的 单元 测试 。 这 种 做 法 没 错 。 实 际 
上 ， 这 也 是 让 函数 按 你 设想 的 方式 执行 的 唯一 途 
径 。 不 过 ,“ 可 以 工作 ”周围 的 引号 可 不 能 一 直 保 


5 
EH o 














ERUKE CERENA, MNH CLER 
ET 它 是 怎么 工作 的 。 通 过 全 部 测试 还 不 够 好 。 
你 必须 知道 OO) 解决 方案 是 正确 的 。 

获得 这 种 知识 和 理解 的 最 好 途径 ， 往 往 是 重 构 
函数 ， 得 到 攻 种 整洁 而 足 具 表达 力 、 清 楚 呈 示 如 何 
工作 的 东西 。 

G22: 把 逻辑 依赖 改 为 物理 依赖 


如 果 汞 个 模块 依赖 于 故 一 个 模块 ， 依 赖 束 该 是 
物理 上 的 而 不 是 逻辑 上 的 。 依 赖 者 模块 不 应 对 被 依 
MERKRA BE REZ, BHK) o CMH 








确 地 询问 后 者 全 部 信息 。 


例如 ， 想像 你 在 编写 一 个 打印 出 雇员 工作 时 长 
的 纯 文 本 报表 的 函数 。 有 个 名 为 HourlyReporter 的 
类 把 数据 收集 为 某 种 方便 的 形式 ， 传 递 到 
HourlyReportFormatter 中 ， 再 打印 出 来 。 (如 代码 
清单 17-1 所 示 。 


代码 清单 17-1 HourlyReporter.java 





public class HourlyReporter { 
private HourlyReportFormatter formatter; 
private List«LineItem» page; 
private final int PAGE SIZE - 55; 


public HourlyReporter(HourlyReportFormatter formatter) { 
this.formatter = formatter; 
page = new ArrayList«LineItem-»(); 


public void generateReport(List<HourlyEmployee> employees) { 
for (HourlyEmployee e : employees) { 
addLineltemToPage(e); 
if (page.size() -- PAGE SIZE) 
printAndClearItemList(); 
} 
if (page.size() > 0) 
printAndClearItemList(); 
} 


private void printAndClearItemList() { 
formatter.format(page); 
page.clear(); 


private void addLineltemToPage(HourlyEmployee e) { 
Lineltem item - new LineItem(); 
item.name - e.getName(); 
item.hours - e.getTenthsWorked() / 10; 


item.tenths = e.getTenthsWworked() % 10; 
page.add(item); 


public class LineItem ( 
public String name; 
public int hours; 
public int tenths; 





这 段 代码 有 尚未 物理 化 的 逻辑 依赖 。 你 能 指出 








来 吗 ? 那 就 是 常量 PAGE_SIZE。HourlyReporter 为 
什么 要 知道 页 面 尺寸 ? 页 面 尺 寸 只 该 是 
HourlyReportFormatter 的 权 责 。 


PAGE_SIZE 在 HourlyReporter 中 声明 ， 人 代表 了 
一 种 位 置 错误 的 权 黄 [G17]， 导 致 HourlyReporter 假 
定 它 知道 页 面 尺 寸 。 这 类 假设 是 一 种 逻辑 依赖 。 
HourlyReporter 依 赖 于 HourlyReportFormatter 能 应 付 
55 的 页 面 尺寸 。 如 果 HourlyReportFormatter 的 某 些 
实现 不 能 处 理 这 样 的 尺寸 ， 就 会 出 错 。 


可 以 通过 创建 HourlyReport 中 名 为 
getMaxPageSize( ) 的 新 方法 来 物理 化 这 种 依赖 。 
HourlyReporter 将 调用 这 个 方法 ， 而 不 是 使 用 
PAGE_SIZE 常 量 。 








G23: 用 多 态 蔡 代 If/Else 或 Switch/Case 








有 了 第 6 章 谈 及 的 主题 ， 这 条 建议 看 似 奇 怪 。 
在 那 章 中 ， 我 提出 在 添加 新 函数 其 于 添加 新 类 型 的 
系统 中 ，switch 语 句 是 恰当 的 。 


首先 ， 多 数 人 使 用 switch 语 句 ， 因 为 它 是 最 直 
规 了 当 又 有 力 的 方案 ， 而 不 是 因为 它 适 合 当前 情 
形 。 这 给 我 们 的 局 发 是 在 使 用 switch 之 前 ， 先 考虑 


使 用 多 态 。 


其 次 ， 函 数 变 化 其 于 类 型 变化 的 情形 相对 宇 
见 。 每 个 switch 语 句 都 值得 怀疑 。 


我 使 用 所 谓 “ 单 个 switch” 规 则 :， SFA EN 
择 类 型 ， 不 应 有 多 于 一 个 switch 语 句 。 在 那个 
switch 语 句 中 的 多 个 case， 必 须 创 建 多 态 对 象 ， 取 
代 系 统 中 其 他 类 似 switch 语 句 ]。 


G24: 遵循 标准 约定 


每 个 团队 部 应 休 循 基于 通用 行业 规范 的 一 套 编 
人 码 标准 。 编 码 标准 应 指定 诸如 在 何 处 声明 实体 变 
量 ， 如 何 命名 类 ， 方 法 和 变量 ， 在 何 处 放置 括号 ， 
等 等 。 团 队 不 应 用 文档 描述 这 些 约定 ， 因 为 代码 本 
吴 提供 了 范例 。 


队 中 的 每 个 成 员 都 应 齐 循 这 些 约 定 。 这 意味 
看 每 个 团队 成 员 必须 成 熟 到 能 了 解 只 要 全 体 同 总 在 
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如 果 你 想 知 道 我 遵循 哪些 约定 ， 可 以 查看 代码 
清单 B-7 一 B-14 中 重 构 之 后 的 代码 。 


G25: Hm A T E BARERNA 


这 大 概 是 软件 开发 中 最 古老 的 规则 之 一 了 。 我 
记得 ， 在 20 志 纪 60 年 代 介 绍 COBOL、FORTRAN 和 
PL/1 的 手册 中 就 读 到 过 。 在 代码 中 出 现 原始 形态 数 
字 通 常 来 说 是 坏 现象 。 应 该 用 良好 命名 的 常量 来 隐 
藏 它 。 

















例如 ， 数 字 86400 应 当 藏 在 常量 
SECONDS PER_DAY 后 面 。 如 果 每 页 打印 55 行 ， 
则 常数 55 应 该 藏 在 常量 LINES PER PAGE 后 面 。 


有 些 和 常量 与 非常 具有 自我 解释 能 力 的 代码 协同 
工作 时 ， 如 此 易于 识别 ， 也 就 不 必 总 是 需要 命名 党 
tO S o mu: 

















double milesWwalked = feetWalked/5280.0; 
int dailyPay - hourlyRate * 8; 
double circumference - radius * Math.PI * 2; 





在 上 例 中 ， 我 们 真 需 要 常量 


FEET PER MILE、WORK_HOURS_PER_DAY 和 
TWO 吗 ? 显然 ， 最 后 那个 很 可 笑 。 有 些 情 况 下 ， 常 
旦 直接 写作 原始 形态 数字 会 更 好 。 你 可 能 会 质疑 
WORK HOURS PER DAY， 因 为 约定 规则 可 能 会 
改变 。 男 一 方面 ， 在 这 里 直接 用 数字 8 读 起 来 很 舒 
服 ， 也 就 没 必要 非 用 17 个 额外 的 字母 来 加 重读 者 负 
担 不 可 。 对 于 FEET_ PER _MILE， 数 字 5280 众 人 名 
E 意义 独特 ， 即 便 没 有 上 和 下文 环境 ， 读 者 也 能 识 
别 它 。 











3.141592653589793 之 类 负数 也 众所周知 ， 很 容 
易 识 别 。 不 过 ， 如 果 直 接 使 用 原始 形式 ， 却 很 有 可 
能 出 错 。 每 次 有 人 看 到 3.141592653589793， 都 会 知 
道 那 是 r 值 ， 从 而 不 会 去 仔细 查看 。 《你 发 现 那个 
错误 的 数字 了 吗 ? ) 我 们 不 想 要 人 们 使 用 3.14、 
3.14159 或 3.142 等 。 所 以 ， 为 我 们 定义 好 Math.PI 是 
件 好 事 。 


TE EAR BU? DM 2 DBF o EIZIE A BE 
目 我 描述 的 符号 。 例 如 ; 


assertEquals(7777, Employee.find("John Doe").employeeNumber()); 


EST ed HEURE PRA RARE FN RE 
777， 它 的 意义 并 不 明确 。 第 二 个 魔术 数 是 John 








oe， 因 为 其 意图 不 明显 。 


John Doe 是 开 友 团队 创建 的 测试 数据 中 编写 为 
#7777 的 雇员 。 团 队 中 每 个 成 员 都 知道 ， 当 连接 到 
数据 库 时 ， 里 面 己 经 有 数 个 雇员 信 BM, FARE 
都 是 大 家 熟知 的 。 所 以 ， 这 个 测试 应 该 读 作 : 





assertEquals 
HOURLY EMPLOYEE ID, 
Employee.find(HOURLY EMPLOYEE NAME).employeeNumber()); 


G26: 准确 


望 某 个 查询 的 第 一 次 匹配 就 是 唯一 匹配 可 
Mi. 用 浮 点 数 表 示 货 币 几 近 于 犯罪 。 因 为 
你 不 想 做 并 发 更 新 就 避免 使 用 锁 和 /或 事务 管理 往 好 
处 说 也 是 一 种 懒惰 行为 。 在 可 以 用 List 的 时 候 非 要 
把 变量 声明 为 ArrayList 就 过 分 拘束 了 。 把 所 有 变量 
设置 为 protected 却 不 够 自律 。 


在 代码 中 做 决定 时 ， 确 认 目 己 足 够 准确 。 明 
确 目 己 为 何 要 这 么 做 ， 如 果 遇 到 寞 常情 况 如 何 处 
理 。 列 懒得 理会 决定 的 准确 性 。 如 果 你 打算 调用 可 
能 返回 null 的 函数 ， 确 认 目 己 检查 了 null 值 。 如 条 得 
询 你 认为 是 数据 库 中 唯一 的 记录 ， 确 保 代 人 码 检查 不 
存在 其 他 记录 。 如 果 要 处 理 货 币 数据 ， 使 用 整数 











1 ， 并 恰当 地 处 理 四 售 五 入 。 如 果 可 能 有 并 发 更 
新 ， 确 认 你 实现 了 菜 种 锁定 机 制 |。 


代码 中 的 含糊 和 不 准确 要 么 是 意见 不 同 的 结 
R, RART. TEERAA, MERR o 


G27: 结构 其 于 约定 


坚守 结构 其 于 约定 的 设计 决策 。 命 名 约定 很 
好 ， 但 却 次 于 强制 性 的 结构 。 例 如 ， 用 到 良好 命名 
的 枚 举 的 Switchycase 要 弱 于 拥有 抽象 方法 的 基 类 。 
没 人 会 被 强迫 每 次 都 以 同样 方式 实现 Switch/case 语 
句 ， 但 基 类 却 让 具体 类 必须 实现 所 有 抽象 方法 。 


G28: 封装 条 件 
如 果 没 有 if 或 while 语 句 的 上 下 文 ， 布尔 逻辑 束 


TY 














例如 : 


if (shouldBeDeleted(timer)) 


要 好 于 


if (timer.hasExpired() && !timer.isRecurrent()) 


G29: itt 定性 条 件 


否定 式 要 比 肯 定式 难 明白 一 些 。 所 以 ， 尽 可 能 
将 条 件 表 示 为 肯定 形式 。 例如 : 


if (buffer.shouldCompact()) 


zur 


if (!buffer.shouldNotCompact()) 


G30: 函数 只 该 做 一 件 事 

编写 执行 一 系列 操作 的 包括 多 段 代 码 的 函数 和 常 
MEAN. KR 关 函 数 做 了 不 只 一 件 事 ， 应 该 转 
换 为 多 个 更 小 的 函数 ， 每 个 只 做 一 件 事 。 


例如 : 








public void pay() { 
for (Employee e : employees) { 
if (e.isPayday()) { 
Money pay - e.calculatePay(); 
e.deliverPay(pay); 


这 段 代 码 做 了 三 件 事 。 它 遍历 所 有 雇员 ， 检 查 
是 否 该 给 雇员 付 工 资 ， 然 后 支付 薪水 。 人 代码 可 以 写 
得 更 好 ， 如 : 


public void pay() (1 
for (Employee e : employees) 
paylIfNecessary(e); 
} 


private void payIfNecessary(Employee e) { 
if (e.isPayday()) 
calculateAndDeliverPay(e); 


j 


private void calculateAndDeliverPay(Employee e) ( 
Money pay - e.calculatePay(); 
e.deliverPay(pay); 


j 
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G31: fink eR 
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它 。 排 列 函 数 参 数 ， 好 让 它们 被 调用 的 次 序 显 而 易 
见 。 看 下 列 代码 : 


public class MoogDiver { 
Gradient gradient; 
List«Spline» splines; 


public void dive(String reason) { 
saturateGradient(); 
reticulateSplines(); 
diveForMoog(reason); 


j 








三 个 函数 的 次 序 很 重要 。 捕 鱼 之 前 先 织 网 ， 织 
网 之 前 先 编 强 。 不 驻 的 是 ， 代 人 码 并 没有 强制 这 种 时 
序 厢 合 。 其 他 程序 员 可 以 在 调用 saturateGradient 之 
前 调用 reticulateSplines， 从 而 导致 抛 出 
UnsaturatedGradientExceptiony 55. EUW PIN 3X 
是 : 





public class MoogDiver { 
Gradient gradient; 
List«Spline» splines; 


public void dive(String reason) ( 
Gradient gradient - saturateGradient(); 
List<Spline> splines = reticulateSplines(gradient); 


diveForMoog(splines, reason); 


} 





这 样 就 通过 创建 顺序 队列 暴露 了 时 序 精 合 。 


个 函数 者 产生 出 下 一 个 函数 所 需 的 结 末 ， 这 样 一 来 
LC EB H AS TEMP VL]. Y o 


V RT BE HS a TS ERAT) AZ ARE, CE 
不 过 这 点 额外 的 复杂 度 却 曝露 了 该 种 情况 真正 的 时 
序 复杂 性 。 


注意 我 保留 了 那些 实体 变量 。 我 假设 关中 的 私 
有 方法 可 能 会 用 到 它们 。 即 便 如 此 ， 我 还 是 希望 参 
数 能 让 时 友 厢 合 变 得 可 见 。 


G32: 别 随 意 


构建 代码 需要 理由 ， 而 且 理 由 应 与 代码 结构 相 
契合 。 如 果 结 构 显 得 太 随 意 ， 其 他 人 就 会 想 修 改 
它 。 如 果 结 构 目 始 至 终 保持 一 致 ， 其 他 人 融会 使 用 
它 ， 并 且 痢 循 其 约定 。 例 如 ， 我 最 近 对 FitNesse 做 
合并 修改 ， 发 现 有 位 页 献 者 这 么 做 : 




















public class AliasLinkWidget extends ParentWidget 


public static class VariableExpandingWidgetRoot ( 





问题 在 于 ，VariableExpandingWidgetRoot 没 必 


要 在 AliasLinkWidget 作 用 范围 之 内 。 而 且 ， 其 他 无 
天 的 类 也 用 到 
AliasLinkWidget.VariableExpandingWidgetRoot。 这 
些 类 没 必 要 了 解 AliasLinkWidget。 


或 许 那 位 程序 员 只 是 循 例 把 
VariableExpandingWidgetRoot 放 到 AliasWidget 里 
面 ， 或 者 他 真 认为 这 么 做 是 对 的 。 不 管 原因 是 什 
么 ， 结 果 都 显得 随心 所 欲 。 不 作为 类 工具 的 公共 
类 ， 不 应 该 放 到 其 他 类 里 面 。 惯 例 是 将 它 置 为 
public， 并 且 放 在 代码 包 的 顶部 。 


G33: 封装 边界 条 件 
边界 条 件 难 以 追踪 。 把 处 理 边界 条 件 的 代码 集 


中 到 一 处 ， 不 要 散落 于 代码 中 。 我 们 不 想见 到 四 处 
散 见 的 +1 和 -1 字样 。 看 看 这 个 来 和 目 FIT 的 简单 例 
es 








if(level + 1 < tags.length) 


parts = new Parse(body, tags, level + 1, offset + endTag); 
body = null; 


i 





JER, level + 1 出 现 了 两 次 。 这 是 个 应 该 封装 
到 名 为 nextLevel 之 类 的 变量 中 的 边界 条 件 。 





int nextLevel = level + 1; 
if(nextLevel « tags.length) 


{ 


parts = new Parse(body, tags, nextLevel, offset + endTag); 


body = null; 
} 








G34: 函数 应 该 只 在 一 个 抽象 层级 上 


函数 中 的 语句 应 该 在 同一 抽象 层级 上 ， 访 层级 
应 该 是 函数 名 所 示 操 作 的 下 一 层 。 这 可 能 是 最 难 理 
解 和 遵循 的 司 发 。 尽 管 概念 足够 直 白 ， 人 们 还 是 很 
Ilem 例如 ， 请 看 下 面 来 目 FitNesse 
JAT: 


public String render() throws Exception 


{ 








StringBuffer html = new StringBuffer ("<hr"); 
if (size > 0) 
html.append(" size=\"").append(size + 1).append("\""); 


html.append(">"); 


return html.toString(); 





稍微 研究 一 下 ， 你 束 会 看 到 及 生 了 什么 。 该 了 
数 构 建 了 绘制 横贯 页 面 线条 的 HTML 标 记 。 线 条 高 
度 在 size 变 量 中 指定 。 


HAH. TIRMA T POWDR. 





一 个 是 横 线 有 尺寸 这 个 概念 。 第 二 个 是 hr 标记 上 自 续 
的 语法 。 这 上段 代码 来 自 FitNesse 的 HruleWidget 模 
块 。 访 模块 检测 一 行 4 个 或 更 多 个 破 折 号 ， 并 将 其 
转换 为 恰当 的 hr 标记 。 破 折 号 越 多 ， 尺 寸 越 大 。 


我 重 构 了 这 段 代码 。 注 意 ， 我 修改 了 size 字 段 
的 名 称 ， 反 映 其 真正 目的 。 它 表示 额外 破 折 号 的 数 


里 o 





public String render() throws Exception 


HtmlTag hr = new HtmlTag("hr"); 
if (extraDashes » 0) 
hr.addAttribute("size", hrSize(extraDashes)); 
return hr.html(); 
} 


private String hrSize(int height) 


int hrSize = height + 1; 
return String.format("%d", hrSize); 








RIE OUR RIF SPAHR. b 
render 只 构造 一 个 hr 标记 ， 不 去 管 该 标记 的 HTML 语 
法 。 而 HtmlTag 模 块 则 照管 所 有 这 些 及 脏 的 语法 问 
题 。 

做 出 修改 时 ， 我 肥 现 了 一 处 微小 的 错误 。 原 始 
代码 没有 加 上 hr 标记 的 结束 和 斜 线 从 ， 而 XHTML 标 


准 要 求 这 样 做 。 换言之， 代码 使 用 了 <hr> 而 不 是 
«hr/». ) HtmlTag 模 块 很 早 就 改造 成 符合 XHTML 
标准 了 。 


拆 分 不 同 抽象 层级 是 重 构 的 最 重要 功能 之 一 ， 
也 是 最 难 做 的 一 个 。 以 下 面 的 代码 为 例 。 这 是 我 第 
一 次 尝试 拆 分 HruleWidget.rendermethod 中 的 抽象 层 
级 的 结果 。 











public String render() throws Exception 


HtmlTag hr = new HtmlTag("hr"); 
if (size » 0) ( 
hr.addAttribute("size", ""+(sizet+1)); 


} 
return hr.html(); 





此 时 ， 我 的 目的 是 做 必要 的 拆 分 ， 并 让 测试 通 
过 。 我 轻易 达到 了 这 一 目的 ， 但 结 末 是 该 函数 仍然 
混杂 了 多 个 抽象 层级 。 此 时 ， 混 杂 的 层级 是 hr 标记 
的 构建 ， 以 及 size 变 量 的 翻译 和 格式 化 。 这 说 明 当 
你 颂 抽 象 界 线 拆 解 函 数 时 ， 经 常会 挖 出 原本 被 之 前 
的 结构 所 掩蔽 的 新 抽象 界线 。 


G35: 在 较 高 层级 放置 可 配置 数据 
如 果 你 有 个 已 知 并 该 在 较 高 抽象 层级 的 默认 




















量 或 配置 值 ， 不 要 将 它 埋藏 到 较 低 层级 的 函数 中 。 
把 它 作 为 较 高 层级 函数 调用 较 低 层级 函数 时 的 一 个 
参数 。 看 看 以 下 来 自 FItNesse 的 代码 : 








public static void main(String[] args) throws Exception 
Arguments arguments - parseCommandLine(args); 
pos 
public class Arguments 


i 
public static final String DEFAULT PATH - "." 


© 
public static final String DEFAULT ROOT = "FitNesseRoot"; 
public static final int DEFAULT PORT - 80; 
public static final int DEFAULT VERSION DAYS - 14; 


J 








命令 行 参数 在 FitNesse 中 的 第 一 行 可 执行 代码 
得 到 解析 。 这 些 参数 的 默认 值 在 Argument 类 的 顶部 
指定 。 你 不 必 到 系统 的 较 低层 级 去 查看 类 似 的 语 
^H]: 


if (arguments.port -- 0) // use 80 by default 


位 于 较 高 层级 的 配置 性 常量 易于 修改 。 它 们 癌 
贯穿 应 用 程序 。 应 用 程序 的 较 低 层级 并 不 拥有 这 
e et HJE o 























G36: 避免 传递 浏览 


通常 我 们 不 想 让 某 个 模块 了 解 太 多 其 协作 者 的 
Ae. BAA, WRASBIME, BSCUME, 
我 们 不 想 让 使 用 A 的 模块 了 解 C 的 信息 。《 例 如 ， 
我 们 不 想 写 类 似 a.getB( ).getC( ).doSomething( ) 的 代 
fe) 





XXL ae Aria aN HE. The Pragmatic 
Programmers 《中 译 版 《程序 员 修 炼 之 道 》) 称 之 
为 “编写 害羞 代码 ”4 。 两 者 都 归结 为 确保 模块 只 
了 解 其 直接 协作 者 ， 不 了 解 整个 系统 的 游 宽 图 。 


如 果 有 多 个 模块 使 用 类 似 a.getB( ).getC( ) 这 样 
的 语句 形式 ， 就 难以 修改 设计 和 架构 ， 在 B 和 CC 之 
间 插 进 一 个 Q。 你 得 找到 a.getB( ).getC( ) 出 现 的 所 有 
地 方 ， 并 将 其 改 为 a.getB( ).getQ( ).getC( )。 系 统 就 
i ee PER 


正确 的 做 法 是 让 直接 协作 者 提供 所 需 的 全 部 服 


务 。 不 必 和 逛 轴 系统 的 对 象 全 图 ， 搜 寻 我 们 要 调用 的 
方法 。 只 要 人 简单 地 说 : 


myCollaborator.doSomething(). 





17.5 Java 
J1: 通过 使 用 通配符 避免 过 长 的 导入 清单 


如 果 使 用 了 来 自 同一 程序 包 的 两 个 或 多 个 类 ， 
用 以 下 语句 导入 整个 包 : 


import package.*; 


过 长 的 导入 清单 令 读者 望而却步 。 我 们 不 想 用 
80 行 导入 语句 搞 乱 模块 项 部 位 置 。 我 们 想 要 导入 语 
句 简 约 地 列 出 我 们 要 使 用 的 包 。 


指定 导入 包 和 是 种 使 依 赖 ， 而 通配符 导入 则 不 
Eo WRIA MRE PART, RDA df 
在 。 但 如 果 你 用 通配符 导入 东 个 包 ， 则 不 需要 存在 
具体 的 类 。 导 入 语句 只 是 在 搜寻 名 称 时 把 这 个 包 列 
入 俘 找 路 径 。 所 以 ， 这 种 导入 并 未 构成 真正 的 依 
RA, TLE TT RBS HEE o 


有 时 ， 长 长 的 具体 导入 清单 也 会 有 用 。 例 如 ， 
如 果 你 在 处 理 遗 留 下 来 的 代码 ， 想 要 找 出 需要 为 哪 
些 类 构造 蔡 身 类 和 占 位 代码 ， 束 可 以 志 历 导入 消 
单 ， 找 出 这 些 类 的 真名 ， 再 恰当 地 放置 占 位 代码 。 























不 过 ， 这 种 用 法 很 罕见 。 而 且 ， 多 数 现 代 IDE 人 允许 
你 用 一 个 命令 束 把 通配符 导 入 语句 转换 为 指定 叶 

清单 。 所 以 ， 即 便 在 处 理 遗 留 代码 时 ， 最 好 也 用 通 
配 符 导 入 。 


通配符 导入 有 时 会 导致 名 称 冲 突 和 监 义 。 两 个 
同名 但 位 于 不 同 包 中 的 类 需要 指名 导入 ， 或 全 少 在 
使 用 时 指定 名 称 。 这 种 情形 的 确 讨厌 ， 不 过 很 罕 
见 ， 所 以 使 用 通配符 寻 入 通 香 仍 优 于 指定 名 称 寻 
Ae 


J2: 不 要 继承 常量 
我 见 过 这 种 情况 好 几 次 ， 它 总 是 让 我 面 露 苦 


Ro FN AEP TERE PS EE ee, 再 通过 继承 结 
构 来 访问 这 些 和 常量 。 看 看 以 下 代码 : 


























public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 


public Money calculatePay() ( 
int straightTime - Math.min(tenthsWorked, TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 


hourlyRate * (tenthsworked + OVERTIME RATE * overTime) 





常量 TENTHS PER_WEEK 和 
OVERTIME_RATE 来 和 目 何 方 ? 它们 可 能 来 目 
Employee 类 。 来 看 看 : 





public abstract class Employee implements PayrollConstants ( 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 


j 





不 ， 不 在 那儿 。 不 过 在 哪儿 呢 ? 再 仔细 看 
Employee 类 。 它 实现 了 PayrollConstants 接 口 。 


public interface PayrollConstants { 
public static final int TENTHS PER WEEK - 400; 
public static final double OVERTIME RATE = 1.5; 


j 








真是 丑陋 不 堪 ! 常量 躲 在 了 继承 结构 的 最 顶 
Ai. RE! 别 利用 继承 欺骗 编程 语言 的 作用 范围 规 
则 。 应 该 用 静态 导入 。 











import static PayrollConstants.*; 


public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 


public Money calculatePay() ( 
int straightTime - Math.min(tenthsWorked, TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 
hourlyRate * (tenthsworked + OVERTIME RATE * overTime) 
); 
} 





J3: "HE vs. 枚 举 


现在 enum 已 经 加 入 Java 语 言 (Java5) ， 放 心 
HE! 别 再 用 那个 public static final int 老 花招 。 那 样 
做 int 的 意义 就 霄 失 了 ， 而 用 enum 则 不 然 ， 因 为 它们 
隶属 于 有 名 称 的 枚 举 。 


而 且 ， 仔 细 研 究 enum 的 语法 。 它 可 以 拥有 方法 
和 字段 ， 从 而 成 为 能 比 int 提 供 更 多 表达 力 和 有 灵活 性 
的 强 有 力 工 具 。 看 看 以 下 发 薪 代 人 码 中 的 不 同 做 法 : 














public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
HourlyPayGrade grade; 


public Money calculatePay() ( 
int straightTime = Math.min(tenthsWorked, TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 
grade.rate 


() * (tenthsWorked + OVERTIME RATE * overTime) 


1 


} 
ne 


public enum HourlyPayGrade { 
APPRENTICE { 
public double rate() { 
return 1.0; 
} 


ty 
LEUTENANT JOURNEYMAN { 


public double rate() ( 
return 1.2; 
} 


tr 
JOURNEYMAN { 


public double rate() { 
return 1.5; 


public double rate() { 
return 2.0; 


H 


public abstract double rate(); 
j 





17.6 ”名 称 
N1; 采用 描述 性 名 称 


不 要 太 快 取 名 。 确 认 名 称 具 有 描述 性 。 记 住 ， 
事物 的 意义 随 痢 软件 的 演化 而 变化 ， 所 以 ， 要 经 各 
性 地 重新 估量 名 称 是 售 恰 当 。 


这 不 仪 是 一 条 “感觉 民 好 式 ” 建 议 。 软 件 中 的 名 
称 对 于 软件 可 恋 性 有 90% 的 作用 。 你 要 花 时 间 明 智 
地 取 名 ， 保 持 名 称 有 关 。 名 称 太 重要 了 ， 不 可 随意 








看 看 以 下 代码 。 这 段 代码 是 做 什么 的 ? 用 了 好 
名 称 的 代码 一 目 了 然 ， 而 这 样 的 代码 却 是 符号 条 
AINSI AS o 








public int x() { 
int q = 0; 
int z = 0; 
for (int kk = 0; kk < 10; kk++) { 
if (1[z] == 10) 
{ 


q += 10 + (1[z + 1] + 1[z + 2]); 
z += 1; 


} 
else if (1[z] + l[z + 1] == 10) 
{ 


q t= 10 + 1[z + 2]; 
Z += 2; 


) else ( 
q += 1[z] + 1[z + 1]; 
Z += 2; 


} 


return q; 





下 和 面 是 这 段 代 码 应 该 写成 的 样子 。 代 码 厂 段 实 
际 上 不 如 上 段 完 整 。 但 你 还 是 能 马上 推 肝 出 它 要 做 
什么 ， 而 且 很 有 可 能 依据 推断 出 的 意思 写 出 遗漏 的 
i Senne coer: 





public int score() { 
int score = 0; 
int frame = 0; 
for (int frameNumber = 0; frameNumber < 10; frameNumber++) { 
if (isStrike(frame)) { 
score += 10 + nextTwoBallsForStrike(frame) ; 
frame += 1; 
} else if (isSpare(frame)) { 


score += 10 + nextBallForSpare(frame); 
frame += 2; 


) else { 


score += twoBallsInFrame(frame); 
frame += 2; 


j 


return score; 


j 








仔细 取 好 的 名 称 的 威力 在 于 ， 它 用 摘 述 性 信息 


缆 关 了 代码 。 这 种 信息 敌 闸 设 定 了 读者 对 于 模块 中 
其 他 函数 行为 的 期 每 。 看 看 上 面 的 代码 ， 你 就 能 推 
靳 出 isStrike() 的 实现 。 恋 到 isStrick 方 法 时 ， 它 “ 深 


合 你 意 ” Us! 





private boolean isStrike(int frame) { 


return rolls[frame] == 10; 


j 





N2: 名 称 应 与 抽象 层级 相符 


不 要 取 沟 通 实现 的 名 称 ;， 取 反映 类 或 函数 抽象 
层级 的 名 称 。 这 样 做 不 容易 。 人 们 擅长 于 混杂 抽象 
层级 。 每 次 浏 斋 代码 ， 你 总 会 及 现 有 些 变量 的 名 称 
层级 太 低 。 你 应 当 趁机 为 之 改名 。 要 让 代码 可 该 ， 
需要 持续 不 断 的 改进 。 看 看 下 面 的 Modem 接 口 : 








public interface Modem { 
boolean dial(String phoneNumber); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 


String getConnectedPhoneNumber ( ) ; 


j 





HEALT. KAARE E, XT ERUH 
程序 来 说 是 这 样 。 不 过 ， 想 想 看 某 个 应 用 中 有 些 调 
制 解 调 磺 并 不 用 拨号 连接 的 情形 。 有 些 用 线 顷 直 连 


(就 像 如 今 为 多 数 家 姓 提 供 Internet 连 接 的 线 统 解 调 
ax) 的 情形 。 有 些 通过 辐 USB 口 发 送 端口 信息 连 
接 。 显 然 ， 有 关 电 话 号 人 码 的 信息 就 是 位 于 错误 的 抽 
象 层 级 了 。 对 于 这 种 情形 ， 更 好 的 命名 案 略 可 能 


Hi 
AE 


public interface Modem { 
boolean connect(String connectionLocator); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 


String getConnectedLocator(); 


j 





现在 名 称 再 不 与 电话 号 公有 关系 。 还 是 可 以 用 
PAH SHS ata, the AAS THEE TH 


N3: 尽 可 能 使 用 标准 命名 法 


如 末 名 称 基 于 既 存 约定 或 用 法 ， 就 比较 易于 理 
fie. BBO, WRIA LS, WIA EZR 
类 命名 时 用 上 Decorator 字 样 。 例 如 ， 
AutoHangupModemDecorator 可 能 是 某 个 给 Modem 
类 刷 上 在 会 话 结束 时 自动 挂机 的 能 力 的 类 的 名 称 。 


模式 只 是 标准 的 一 种 。 例 如 ， 在 Java 中 ， 将 对 
象 转换 为 字符 串 的 函数 通常 命名 为 toString。 最 好 是 
这 循 这 些 约定 ， 而 不 是 目 己 创造 命名 法 。 











TREE, FRANT AHH A On a 
标准 系统 。Eric Evans 称 之 为 项 目的 共同 语言 U4 。 
代码 应 该 使 用 来 自 这 种 语言 的 术语 。 简 言 之 ， 具 有 
与 项 目 有 关 的 特定 意义 的 名 称 用 得 越 多 ， 读 者 就 越 
容易 明白 你 的 代码 是 做 什么 的 。 


N4: FCI CH A ER 


X FAS ARR eA ee LN AR. AAR 
目 FitNesse 的 这 个 例子 : 











private String doRename() throws Exception 


if(refactorReferences) 
renameReferences(); 
renamePage( ); 


pathToRename.removeNameFromEnd( ); 
pathToRename.addNameToEnd (newName) ; 
return PathParser.render(pathToRename); 








该 函数 的 名 称 含混 不 清 ， 没 有 说 明 函 数 的 作 
用 。 由 于 在 doRename 函 数 里 面 还 有 个 名 为 
renamePageH PAI AL, IWR ANAK sf) 这 些 名 称 
没有 说 明 两 个 函数 之 间 的 区 别 呢 ? 没有 。 











renamePageAndOptionallyAllReferences。 看 似 大 


长 ， 的 确 也 很 长 ， 不 过 它 只 在 模块 中 的 一 处 被 调 
用 ， 所 以 其 解释 性 的 好 处 大 过 了 长 度 的 坏处 。 


N5: 为 较 大 作用 范围 选用 较 长 名 称 


名 称 的 长 度 应 与 作用 范围 的 广泛 度 相 关 。 对 于 
较 小 的 作用 范围 ， 可 以 用 很 短 的 名 称 ， 而 对 于 较 大 
作用 范围 就 该 用 较 长 的 名 称 。 


类 似 i 利 j 之 类 的 变量 名 对 于 作用 范围 在 5 行 之 内 
的 情形 没 问 题 。 看 看 以 下 来 目 老 “标准 保龄球 游 
XX" WARS Fr Be: 








private void rollMany(int n, int pins) 


for (int i-0; i«n; i++) 
g.roll(pins); 





这 段 代码 很 明白 ， 如 果 用 rollCount 之 类 烦人 的 
名 称 代 蔡 变量 i， 反 而 是 徒 增 混乱 。 另 一 方面 ， 在 较 
长 距离 上 上， 使 用 短 名 称 的 变量 和 函数 会 丧失 其 合 
gr cmm COE ee 
HHI o 








N6: 5:4 


不 应 在 名 称 中 包括 类 型 或 作用 范围 信息 。 在 如 
今 的 开发 环境 中 ，m_ 或 之 类 前 级 完全 无 用 。 类 似 
vis_〔 表 示 图 形 系统 ) 之 类 的 项 目 或 子 系统 名 称 也 
属 多 余 。 妆 今 的 开发 环境 不 用 纠缠 于 名 称 也 能 提供 
这 些 信息 。 不 要 用 匈牙利 语 命 名 法 污染 你 的 名 称 。 


N7: 名 称 应 该 说 明 副 作用 

名 称 应 该 说 明 函 数 、 变 量 或 类 的 一 切 信息 。 不 
要 用 名 称 掩 下 副 作用 。 不 要 用 简单 的 动词 来 描述 做 
了 不 目 一 个 简单 动作 的 函数 。 例 如 ， 请 看 以 下 来 目 
TestNG 的 代码 : 




















public ObjectOutputStream getOos() throws IOException { 
if (m oos == null) { 
m oos = new ObjectOutputStream(m socket.getOutputStream()); 


return m oos; 


j 








该 国 数 不 只 是 获取 一 个 oos， 如 采 oos 不 存在 ， 
还 会 创建 一 个 。 所 以 ， 更 好 的 名 称 大 概 是 


createOrReturnOos. 


17.7 测试 
TI: 测试 不 足 


一 套 测 试 中 应 该 有 多 少 个 测试 ? SEHE. YT 
多 程序 员 的 衡量 标准 是 “看 起 来 够 了 ”。 一 套 测 试 应 
该 测 到 所 有 可 能 失败 的 东西 。 只 要 还 有 没 被 测试 探 
测 过 的 条 件 ， 或 是 还 有 没 被 验证 过 的 计算 ,测试 就 
还 不 够 。 


T2: FHE ELA 


18 wi K LR. EILC IREKIA ds AR. EH 
T8 wi LAE A de Su SERIA. SS 
函数 。 多 数 IDE 都 给 出 直观 的 指示 ， 用 绿色 标记 测 
试 履 羡 了 的 代码 行 ， 而 未 才 兽 的 代码 行 则 是 红色 。 
快 义 容易 地 找到 尚未 检测 过 的 if 或 catch 
ta Als 


T3: 列 略 过 小 测试 


小 测试 易于 编写 ， 其 文档 上 的 价值 高 于 编号 成 
本 。 






































T4: 被 急 略 的 测试 束 古 对 不 确定 事物 的 疑问 





有 时 ， 我 们 会 因为 需求 不 明 而 不 能 确定 茶 个 行 
为 细节 。 可 以 用 注释 邱 的 测试 或 者 用 @Ignore 标 记 
的 测试 来 表达 我 们 对 于 需求 的 疑问 。 使 用 哪 种 方 
式 ， 取 决 于 该 不 确定 性 所 关 涉 代码 是 否 要 编 详 。 


T5: 测试 边界 条 件 


特别 注意 测试 边界 条 件 。 算 法 的 中 间 部 分 正确 
但 边界 判断 错误 的 情形 很 第 见 。 


T6: IB BL BIS 


缺陷 趋同 于 扎堆 。 在 东 个 函数 中 发 现 一 个 缺陷 
时 ， 最 好 全 面 测试 那个 函数 。 你 可 能 会 发 现 缺陷 不 
i 


T7: 测试 失败 的 模式 有 局 发 性 


有 时 ， 你 可 以 通过 找到 测试 用 例 失败 的 模式 来 
诊断 问题 所 在 。 这 也 是 尺 可 能 编写 足够 完整 的 测试 
用 例 的 理由 之 一 。 完 整 的 测试 用 例 ， 按 合理 的 顺 厅 
排列 ， 能 又 露出 模式 。 


简单 举例 ， 假 设 你 注意 到 所 有 长 于 5 个 字符 的 
得 入 都 会 导致 测试 失败 ， 或 者 同 函 数 的 第 二 个 参数 
传 入 负数 都 会 导致 测试 失败 。 有 时 ， 只 要 看 看 测试 
报告 的 红 绿 模式 ， 束 足以 绕 放 出 那 句 带 来 解决 方法 








的 “ 啊 哈 ! ”回头 看 看 第 16 章 “ 重 构 SerialDate” 中 的 有 
趣 例子 吧 。 


T8: IMAR m KENA Ja ATE 

但 看 被 或 未 被 已 通过 的 测试 执行 的 代码 ， 往 往 
能 友 现 失败 的 测试 为 何 失败 的 线索 。 
T9: 测试 应 该 快速 

慢 速 的 测试 是 不 会 被 运行 的 测试 。 时 间 一 紧 ， 
较 慢 的 测试 就 会 被 摘 挥 。 所 以 ， 竭 尽 所 能 让 测试 
够 快 。 





17.8 ^£ 
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不 能 确定 这 样 一 份 清单 会 不 会 完备 无 缺 。 但 或 许 
完整 性 不 该 是 目标 ， 因 为 该 清单 确实 给 出 了 一 套 
价值 体系 。 


那 倒 价值 体系 才 该 是 目标 ， 也 是 本 书 的 主题 所 
在 。 整 洁 代码 并 非 体 循 一 套 规 则 写 残 。 学 习 一 系列 
局 发 并 不 足以 让 你 成 为 软件 匠人 。 专 业 性 和 技艺 来 
目 于 驱动 规程 的 价值 观 。 
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需要 执行 是 不 一 样 的 。 不 确定 算法 是 否 恰当 司空 见 
惯 ， 而 不 确定 代码 做 什么 却 是 一 种 懒惰 行为 。 





原 注 : 
原 注 : 
原 注 : 


原 注 : 





或 者 用 更 好 的 使 用 整数 的 Money 类 。 
[PRAG]. P. 138. 


见 第 一 章 中 Ward Cunningham] | 


附录 A ”并 发 编程 II 
Brett L.Schuchert 


本 附录 扩充 了 “并 改编 程 ”一 章 的 内 容 ， 由 一 组 
相互 独立 的 主题 组 成 ， 你 可 以 投 随 意 顺 序 阅 读 。 为 
了 实现 这 样 的 阅读 方式 ， 市 与 市 之 间 存 在 一 些 重复 
内 容 。 











AL SP im MRA a BF 


想像 一 个 简单 的 客户 器/ 服务 器 应 用 程序 。 服 
务 骨 在 一 个 套 接 字 上 等 竺 接受 来 目 各 己 冰 的 连接 请 
Ko AP ime BY RA as IP AIS TR o 


A.1.1 服务 器 
下 面 是 服务 器 应 用 程序 的 简化 版 本 代码 。 在 后 


文 “ 客 户 问 /服务 玲 非 多 线程 版 本 ”一 节 中 有 完整 的 代 
人 码 。 











ServerSocket serverSocket = new ServerSocket(8009); 


while (keepProcessing) { 
try d 
Socket socket - serverSocket.accept(); 
process(socket); 
) catch (Exception e) ( 
handle(e); 





这 个 简单 的 应 用 等 待 连接 请 求 ， 处 理 接收 到 的 
新 消 县 ， 再 等 竺 下 一 个 客户 器 请 求 。 下 面 是 连接 到 
Hit o5 ae is) X: 


private void connectSendReceive(int i) ( 


try { 
Socket socket - new Socket("localhost", PORT); 
MessageUtils.sendMessage(socket, Integer.toString(i)); 
MessageUtils.getMessage(socket); 
socket.close(); 

) catch (Exception e) ( 
e.printStackTrace(); 





ix AEP m ARS S8 PEP IS TT fuus? 怎样 
才能 正式 地 描述 其 性 能 ? 下 面 是 断言 其 性 能 “可 接 
受 ” 的 测试 : 








QTest(timeout = 10000) 

public void shouldRunInUnderi0Seconds() throws Exception { 
Thread[] threads - createThreads(); 
startAllThreadsw(threads); 


waitForAllThreadsToFinish(threads); 
j 





为 了 让 例子 够 简单 ， 设 置 过 程 被 忽略 了 《〈 见 后 
文 ClientText.java 部 分 ) 。 测 斌 断言 程序 应 该 在 
10000227) VJ FE e 





这 是 个 验证 系统 吞吐 量 的 典型 例子 。 系 统 应 该 
在 10 秒 钟 以 内 完成 一 组 客户 端 请 求 。 只 要 服务 器 能 
在 时 限 内 处 理 每 个 客户 端 请 求 ， 测 试 就 通过 了 ， 


如 果 测 试 失败 会 怎样 ? 缺少 了 某 些 事件 轮 询 机 








制 ， 在 单个 线程 上 也 没什么 可 让 代码 更 快 的 手段 。 
使 用 多 线程 能 解决 问题 吗 ? 可 能 会 ， 我 们 先 得 了 解 
什么 地 方 耗费 时 间 。 下 面 是 两 种 可 能 : 


。IO_ 使 用 套 接 字 、 连 接 到 数据 库 、 等 待 虚 拟 
内 存 交换 等 
。 处 理 器 一 数值 计算 、 正 则 表达 式 处 理 、 垃 圾 


回收 等 。 


以 上 在 系统 中 部 会 部 分 存在 ， 但 对 于 特定 的 操 
作 ， 其 中 之 一 会 起 主导 人 作用。 如果 代码 运行 速度 主 
要 与 处 理 占 有 大， 增加 处 理 禹 便 件 束 能 提升 在 吐 
量 ， 从 而 通过 测试 。 但 CPU 运算 周期 是 有 上 限 的 ， 
因此 ， 只 和 是 增加 线程 的 话 并 不 会 提升 党 处 理 器 限制 
的 代码 的 速度 。 


另 一 方面 ， 如 果 吞 吐 量 与 TO 有关， 则 并 发 编 
程 能 提升 运行 效率 。 当 系统 的 某 个 部 分 在 等 待 
1/O， 田 一 部 分 就 可 以 利用 等 待 的 时 间 人 处理 其 他 事 
务 ， 从 而 更 有 效 地 利用 了 CPU 能 


A.1.2 VS EX FEET NR 
假定 性 能 测试 失败 了 。 如 何 才能 提高 吞吐 量 、 


通过 性 能 训 试 呢 ? 如果 服 务 器 的 process 方 法 与 1O 
AR, MATINEE as A DRE OA ts BERL 


























processMessage ) : 


void process(final Socket socket) { 
if (socket == null) 
return; 


Runnable clientHandler = new Runnable() { 
public void run() { 
try { 
String message = MessageUtils.getMessage(socket); 
MessageUtils.sendMessage(socket, "Processed: " + message) 


closelgnoringException(socket); 
) catch (Exception e) ( 
e.printStackTrace(); 


Thread clientConnection - new Thread(clientHandler); 
clientConnection.start(); 


j 





BEA Wide YOU 。 代 码 是 否 完整 、 
正确 了 呢 ? 


A.1.3 ”观察 服务 器 端 

修改 了 的 服务 器 成 功 通 过 测试 ， 只 花费 了 一 秒 
多 钟 时 间 。 不 笠 的 是 ， 这 种 解决 手段 有 点 一 厢 情 
愿 ， 而 且 导 致 了 新 问题 产生 。 

服务 器 应 该 创建 多 少 个 线程 ? 代码 没有 设置 上 


限 ， 所 以 我 们 很 有 可 能 达到 Java 虚 拟 机 JVM) 的 
限制 。 对 于 许多 简 时 系统 来 说 这 无 所 谓 。 但 如 来 系 
统 要 文 持 公众 网 络 上 的 众多 用 户 呢 ? 如 果 有 太 多 用 
户 同时 连接 ， 系 统 就 有 可 能 挂 掉 。 


不 过 先 把 性 能 问题 放 到 一 边 吧 。 这 种 手段 还 有 
整洁 性 和 结构 上 的 问题 。 服 务 占 代码 有 多 少 种 权 贡 
HE? 


。 套 接 字 连接 管理 ; 
e 客户 端 处 理 ; 

e 线程 案 略 ; 

e HRA ASK PH RS e 


这 些 权 责 不 幸 全 在 process 函 数 中 。 而 且 ， 代 码 
跨越 多 个 抽象 层级 。 所 以 ， 即 便 process 函 数 这 么 短 
小 ， 还 是 需要 再 加 以 切 分 。 


服务 占有 几 个 修改 的 原因 ， 所 以 它 违 反 了 单一 
权 责 原则 。 要 保持 并 发 系统 整洁 ， 应 该 将 线程 管理 
代码 约束 于 少数 几 处 控制 展 好 的 地 方 。 而 且 ， 管 理 
线程 的 代码 只 应 该 做 管理 线程 的 事 。 为 什么 ? 即便 











无 需 同 时 考虑 其 他 非 多 线程 代码 ， 跟 踪 并 友 问 题 部 
己 经 足够 困难 了 。 





如 果 为 上 述 每 个 权 丙 《包括 线程 管理 权 贡 在 


内 ) 创建 单独 的 类 ， 当 改动 线程 管理 和合 略 时 ， 就 会 
对 整个 代码 产生 较 小 影响 ， 不 至 于 污染 其 他 权 贡 。 
这 样 一 来 ， 也 能 在 不 担心 线程 问题 的 前 提 下 测试 所 
有 其 他 权 贡 。 下 和 面 是 修改 过 的 版 本 : 


public void run() { 
while (keepProcessing) { 
try { 
ClientConnection clientConnection = connectionManager.awai 
tClient(); 
ClientRequestProcessor requestProcessor 
= new ClientRequestProcessor(clientConnection); 
clientScheduler.schedule(requestProcessor); 
) catch (Exception e) ( 
e.printStackTrace(); 


i 


connectionManager.shutdown(); 





所 有 与 线程 相关 的 东西 都 放 到 了 clientScheduler 
里 面 。 如 果 出 现 并 发 问题 ， 只 要 看 这 个 地 方 束 好 
J: 


public interface ClientScheduler { 
void schedule(ClientRequestProcessor requestProcessor ); 


Jj 





TR RU FS 


public class ThreadPerRequestScheduler implements ClientSchedul 
er { 
public void schedule(final ClientRequestProcessor requestProce 
ssor) ( 
Runnable runnable = new Runnable() { 
public void run() { 
requestProcessor.process(); 


}; 


Thread thread = new Thread(runnable); 
thread.start(); 
} 
} 





把 所 有 线程 管理 隔离 到 一 个 位 置 ， 修 改 控 制 线 
程 的 方式 就 容易 多 了 。 例 如 ， 移 植 到 Java 5 
Executor 框 架 就 只 需要 编写 一 个 新 类 并 插 进 来 即 可 
《如 代码 清单 A-1 所 示 ) 。 


代码 清单 A-1 ExecutorClientScheduler.java 





import java.util.concurrent.Executor; 
import java.util.concurrent.Executors; 


public class ExecutorClientScheduler implements ClientScheduler 


{ 


Executor executor; 


public ExecutorClientScheduler(int availableThreads) { 
executor - Executors.newFixedThreadPool(availableThreads); 


j 


public void schedule(final ClientRequestProcessor requestProce 
ssor) ( 
Runnable runnable = new Runnable() { 
public void run() { 
requestProcessor.process(); 


3 


了 
executor.execute(runnable); 





A.1.4 小 结 


本 例 介 绍 的 并 有 编程， 演示 了 一 种 提高 系统 硬 
吐 量 的 方法 ， 以 及 一 种 通过 测试 框架 验证 吞吐 量 的 
方法 。 将 全 部 并 友 代 码 放 到 少数 类 中 ， 是 应 用 单一 
权 贡 原则 的 范例 。 对 于 并 及 编 程 ， 因 其 复杂 性 ， 这 
AREH. 








A.2 执行 的 可 能 路 径 
复 丛 没有 循环 或 条 件 分 文 的 单行 Java 方 法 


incrementValue: 





public class IdGenerator { 
int lastIdUsed; 


public int incrementValue() { 
return ++lastIdUsed; 





忽略 整数 溢出 的 情形 ， 假 定 只 有 单个 线程 能 访 
问 IdGenerator 的 单个 实体 。 这 种 情况 下 ， 只 有 一 种 
执行 路 径 和 一 个 确定 的 结果 : 


e 返回 值 等 于 lastIdUsed 的 值 ， 两 者 都 比 调 用 方法 
BI 1e 


如 果 使 用 两 个 线程 、 不 修改 方法 的 话 会 发 生 什 
么 ? 如 果 每 个 线程 都 调用 一 次 incrementValue， 可 
能 得 到 什么 结果 呢 ? 有 多 少 种 可 能 执行 路 径 ? 首先 
来 看 结果 (假定 lastIdUsed 初 始 值 为 93) : 


e 线程 1 得 到 94， 线 程 2 得 到 95，]lastIdUsed 为 95; 








线程 1 得 到 95， 线 程 2 得 到 94，lastIdUsed 为 95; 
线程 1 得 到 94， 线 程 2 得 到 94，]lastIdUsed 为 94。 


BUR TARR OAM, toe A H fe h I 
的 。 要 想 明 日 为 何 可 能 出 现 这 些 结果 ， 束 需要 理解 
可 能 执行 路 径 的 数量 以 及 Java 虚 拟 机 是 如 何 执行 这 
些 路 径 的 。 


A.2.1 路 径 数 量 


为 了 算出 可 能 执行 路 径 的 数量 ， 我 们 从 生成 的 
字 节 人 码 开始 研究 。 那 行 Java 代 人 码 (return 
++lastIdUsed;) 变 成 了 8 个 字 节 码 指 令 。 两 个 线程 有 
可 能 交错 执行 这 8 个 指令 ， 融 像 庄家 在 洗 牌 时 交错 
牌 张 一 样  。 即 便 每 只 手 上 只 有 8 张 牌 ， 洗 牌 得 到 
的 结果 数量 也 很 可 观 。 


对 于 指令 系列 中 有 N 个 指令 和 T 个 线程 、 没 有 
循环 或 条 件 分 支 的 简单 情况 ， 总 的 可 能 执行 路 径 妆 


量 等 于 








(NT)! 
NIT 





计算 可 能 执行 次 厅 


EA PS EI SEI US Brett HY —3 
电子 邮件 : 


对 于 N 步 指令 和 T 个 线程 ， 总 共有 
T*N IR. TERT BEP TAS ZAI, 
会 有 在 工 个 线程 中 选择 其 一 的 环境 开 
关 。 因 而 每 条 路 径 都 能 以 一 个 数字 字 
符 串 的 形式 来 表示 该 环境 开关 。 对 于 
步骤 A、B 及 线程 1 和 2， 可 能 有 6 条 可 
能 路 径 : 1122、1212、1221、2112、 
2121 和 2211。 或 者 以 指令 步骤 表示 为 
A1B1A2B2, A1A2B1B2, 
A1A2B2B1、A2A1B1B2、A2A1B2B1 
及 A2B2A1B1。 对 于 三 个 线程 ， 执 行 
序列 就 是 112233、112323、113223、 
113232、112233、121233、121323、 
121332, 123132, 123123...... 


这 些 字 符 串 的 特征 之 一 是 每 个 T 总 
会 出 现 N 次 。 所 以 字符 串 111111 是 无 效 
的 ， 因 为 里 面 有 6 个 1， 而 2 和 3 则 未 出 
现 过 。 


PrELSEHEPUZH NI. N2......É 8 
NT。 这 其 实 就 是 N* T 对 应 N*T 的 排 
列 ， 即 (N*T)!， 但 要 剔除 重复 的 情 
形 。 所 以 ， 巧 妙 之 处 就 在 于 计算 重复 
次 数 并 从 (N*T)! 中 剔除 掉 。 








对 于 两 步 指令 和 两 个 线程 ， 有 多 
少 重复 呢 ? 每 个 四 位 数字 符 串 中 都 有 
两 个 1 和 两 个 2。 每 个 这 种 配对 都 可 以 
在 不 影响 字符 串 意 义 的 前 提 下 调换 。 
可 以 同时 调换 全 部 1 和 2， 也 可 以 都 不 
调换 。 所 以 每 个 字符 串 就 有 四 种 同 构 
WAS, BIEXE3UGR E. BRA — 
的 路 径 是 重复 的 ; 而 四 分 之 一 的 排列 
则 不 重复 。4!*.25=6。 这 样 计算 看 来 可 
fT. 




















有 多 少 重复 呢 ? 对 于 N=1 且 T=2 的 
情形 ， 我 可 以 调换 1， 调 换 2， 或 两 者 
都 调换 。 对 于 N=2 且 T=3 的 情形 ， 我 可 
以 调换 1、2、3，1 和 2，1 和 3， 或 2 和 
3。 调 换 只 是 N 的 排列 组 合 罢 了。 设 有 
N 的 P 种 排列 组 合 。 排 列 组 合 的 方式 总 
共有 P**T 种 。 





所 以 可 能 的 同 构 形态 数量 为 
NI**T。 路 径 的 数量 就 是 
(IT*N)JVINIxs*T)。 对 于 T=2 上 且 N=2 的 情 
况 ， 结 果 就 是 6 〈 即 24/4) 。 


对 于 N=2 且 T=3， 结 果 是 
720/8=90。 


对 于 N=3 且 T=3， 结 果 是 
91/6^3=1680。 


对 于 一 行 Java 代 人 码 ( 等 同 于 8 行 字 节 人 码 〉 和 两 


个 线程 的 简单 情况 ， 可 能 执行 路 径 的 总 数量 束 是 

12870。 如 果 lastIdUsed 的 类 型 为 Jong， 每 次 读 / 写 操 
作 都 变 成 了 两 次 操作 ， 而 可 能 的 次 序 高 达 2704156 
种 。 


如 宋 改 动 一 下 该 方法 会 怎样 ? 





public synchronized 


void incrementValue() { 
++lastIdUsed; 


j 





这 样 一 来 ， 对 于 两 个 线程 的 情况 ， 可 能 执行 路 
径 的 数量 束 是 2， 即 N1!。 


A.2.2 ”深入 挖掘 


两 个 线程 都 调用 方法 一 次 《在 添加 Synchronize 
之 前 ) 、 得 到 同一 结果 数字 的 惊异 结果 又 怎 样 呢 ? 
怎么 可 能 出 现 这 种 情况 ? 一 样 一 样 来 。 


什么 是 原子 操作 ? 可 以 把 原子 操作 定义 为 不 可 
中 断 的 操作 。 例 如 ， 在 下 列 代 码 的 第 5 行 ，0 被 赋值 
给 lastid， 就 是 一 个 原子 操作 。 因 为 依据 Java 内 存 模 
型 ，32 位 值 的 赋值 操作 是 不 可 中 断 的 。 








: public class Example { 
int lastId; 


public void resetId() { 
value - 0; 


j 


public int getNextId() { 
++value; 
} 
T. 





如 果 把 lastId 的 类 型 从 int 改 为 long 会 怎样 ? 第 5 
行 还 是 原子 操作 吗 ? 如 果 不 考虑 JVM 规 约 ， 则 有 可 
能 根据 处 理 器 不 同 而 不 同 。 不 过 ， 根 据 JVM 规 约 ， 
64 位 值 的 赋值 需要 两 次 32 位 赋值 。 这 意味 着 在 第 一 
次 和 第 二 次 32 位 赋值 之 间 ， 其 他 线程 可 能 插 进来 ， 
修改 其 中 一 个 值 。 


第 9 行 的 前 递增 操作 符 ++ 又 怎样 呢 ? 前 递增 操 
作 符 可 以 被 中 断 ， 所 以 它 不 是 原子 的 。 为 了 理解 这 
点 ， 仔 细 复 查 一 下 这 些 方法 的 字 节 码 吧 ， 


在 更 进一步 之 前 ， 有 三 个 重要 的 定义 : 


。 人 框架 一 一 每 个 方法 调用 部 圾 要 一 个 框 保 。 该 框 
染 包 括 返 回 地 址 、 传 入 方法 的 参数 ， 以 及 方法 
中 定义 的 本 地 变量 。 这 是 定义 一 个 调用 堆栈 的 
标准 技术 ， 现 代 编程 语言 用 来 实现 基本 函数 / 方 























法 调用 和 递归 调用 
j 9 每 个 变 


量 。 所 有 非 静 态 方 法 至 少 有 一 个 变量 this， 代 表 
当前 对 象 ， 即 接收 导致 方法 调用 的 《当前 线程 
A) 大 多 数 最 新 消息 的 对 象 ; 

e 运算 对 象 栈 一 Java 虚拟 机 中 的 许多 指令 都 有 参 
数 。 运 算 对 象 栈 是 放置 参数 的 地 方 。 堆 栈 是 个 
标准 的 后 入 先 出 〈LIFO) 数据 结构 。 


下 面 是 restId() 的 字 节 但 ， 如 表 A-1 所 示 。 














表 A-1 restId( ) 的 字 节 码 














将 第 0 个 变量 放 到 操作 对 象 栈 中 。 什 么 是 第 0 个 变量 ? 就 是 this， 当 

前 对 象 。 当 方法 被 调用 ， 消 息 接收 者 ， Vc m 个 实体 ， 被 推 

i 架 的 本 地 变量 数组 中 。 这 总 是 放 进 每 个 实 
LH 
























































将 常量 值 0 放 到 操作 对 象 栈 中 








将 堆栈 中 的 第 一 个 值 《 即 0) 存储 到 引用 对 象 的 字段 值 ， 距 堆栈 顶 
部 this 一 个 对 象 引 用 的 距离 


























这 三 个 指令 确保 是 原子 的 ， 因 为 尽管 执行 它们 
的 线程 可 能 在 其 中 任何 一 个 指令 后 被 打 断 ， 但 
PUTFIELD 指 令 ( 堆 栈 顶 部 的 常量 值 0O 和 顶端 之 下 的 
this 引 用 及 其 字段 值 ) 的 信息 并 不 能 为 其 他 线程 所 


触及 。 所 以 ， 当 赋值 操作 发 生 时 ， 值 0 一 定 将 存储 
到 字段 值 中 。 该 操作 是 原子 的 。 操 作对 象 都 处 理 对 
于 方法 而 言 是 本 地 的 信息 ， 故 在 多 个 线程 之 间 并 天 
冲突 。 





所 以 ， 如 果 这 三 个 指令 由 10 个 线程 执行 ， 就 会 
有 4.38679733629e+24 种 可 能 的 执行 次 序 。 不 过 ， 只 
会 有 一 种 可 能 的 结果 ， 所 以 执行 次 序 不 同 无 天 紧 
要 。 对 于 本 例 中 的 long 稼 量 ， 总 是 有 同一 种 运算 续 
果 。 为 什么 ?因为 10 个 线程 的 赋值 操作 都 是 针对 一 
个 常量 的 。 即 便 它们 互相 干涉 ， 结 果 也 是 一 样 。 























方法 getrNextId 中 的 ++ 操 作 就 会 有 问题 了 。 假 定 
lastId 在 方法 开始 时 的 值 为 42. 下 面 是 新 方法 的 字 节 
码 ， 如 表 A-2 所 示 。 


表 A-2 新 方法 的 字 市 码 


将 this 装 载 到 操作 对 象 栈 
复制 堆栈 顶部 内 容 。 在 对 象 栈 中 有 两 个 this 的 复 本 
lastId is, 






































GETFIELD 从 指向 堆栈 顶部 Cthis) 的 对 象 中 取得 字段 ljastId 的 值 ， 并 存储 this 42 
回 堆栈 中 li 





























IADD 对 堆栈 顶部 的 两 个 值 做 整数 加 操作 ， 将 结果 存储 回 堆 栈 this, 43 


43, this, 
43 


BFUPHURIE 《而且 具 是 大半) 的 人 


设想 第 一 个 线程 完成 了 前 三 个 操作 ， 直 到 执行 
完 GETEFIELD， 然 后 被 打 断 。 第 二 个 线程 接手 并 完 
成 整个 方法 调用 ，lastId 的 值 递增 1;， 得 到 的 值 为 
43。 第 一 个 线程 再 从 中 断 处 继续 执行 ， 操 作对 象 栈 
中 的 值 还 是 42， 因 为 那 束 是 该 线程 执行 GETFIELD 
时 的 lastId 值 。 线 程 给 lastId 加 1， 得 到 43， 存 储 这 个 
结果 。 第 一 个 线程 也 得 到 了 值 43。 结 果 束 是 其 中 一 
个 递增 操作 丢失 了 ， 因 为 第 一 个 线程 在 被 第 二 个 线 
程 打 断 后 又 踏 入 了 第 二 个 线程 中 。 

















































































































将 getNextId() 方 法 修改 为 同步 方法 就 能 修正 这 
个 问题 。 


A.2.3 小 结 
理解 线程 之 间 如 何 互相 干涉 ， 并 不 一 定 要 精通 


字 市 码 。 如 果 你 能 看 明日 这 个 例子 ， 它 应 该 已 经 展 
示 了 多 个 线程 之 间 互 相干 涉 的 可 能 性 ， 这 已 经 足够 





Jie 


这 个 小 例子 说 明 ， 有 必要 尽量 理解 内 存 模型 ， 
明白 什么 是 安全 的 ， 什 么 是 不 安全 的 。 有 一 种 普通 
的 误解 ， 认 为 ++《 前 递增 或 后 递增 ) 操作 符 是 原子 
的 ， 其 实 并 非 如 此 。 你 必须 知道 : 


© HAM ATEN AE 
。 哪些 代码 会 导致 并 发 读 / 写 问题 
。 如何 防止 这 种 并 及 问题 发 生 。 











A.3 了 解 类 库 
A.3.1 Executor/E E 


如 前 文 ExecutorClientScheduler.java 所 演示 的 那 
FÉ. Java 5 中 引入 的 Executor 框 架 文 持 利用 线程 池 进 


行 复 林 的 执行 。 那 束 是 java.util.concurrent 包 中 的 一 
个 类 


如 果 在 创建 线程 时 没有 使 用 线程 池 或 自行 编写 
线程 池 ， 可 以 考虑 使 用 Executor。 它 能 让 代码 更 整 
iG, AYP, ABI). 


Executor 框 架 将 把 线程 放 到 池 中 ， 目 动 调整 其 
大 小 ， 并 在 必要 时 重建 线程 。 它 还 支持 future， 一 
种 通用 的 并 发 编程 构造 。Executor 能 与 实现 了 
Runnable 的 类 协同 工作 ， 也 能 与 实现 了 Callable 接 口 
的 类 协同 工作 。Callback 看 来 束 像 是 Runnable， 但 
它 能 返回 一 个 结果 ， 那 在 多 线程 解决 方案 中 是 普 授 
的 需求 。 


当代 人 码 需 要 执行 多 个 相互 独立 的 操作 并 等 待 这 
些 操作 结束 时 ，future 刚 好 残 手 : 


public String processRequest(String message) throws Exception { 











Callable<String> makeExternalCall = new Callable<String>() { 
public String cart) throws Exception ( 
String result = ""; 
// make external request 
return result; 


}; 

Future<String> result = executorService.submit(makeExternalCal 
/ 

String partialResult = doSomeLocalProcessing(); 


return result.get() + partialResult; 


j 








在 本 例 中 ， 方 法 开始 执行 makeExternalCall 对 
象 。 然 后 该 方法 继续 其 他 操作 。 最 后 一 行 代码 调 用 
result.get()， 在 future 代 码 执行 完成 前 ， 这 个 操作 是 
锁定 的 。 


A.3.2 APSE AR RTT 
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《从 而 也 是 锁定 的 ) 来 提供 线程 安全 地 更 新 一 个 值 
的 类 : 





public class ObjectWithValue { 
private int value; 
public void synchronized incrementValue() { ++value; } 
public int getValue() { return value; } 


i; 





Java5 有 一 系列 用 于 此 类 情况 的 新 类 ， 例 如 
AtomicBoolean. AtomicInteger#/ AtomicReference 
等 ;还 有 另外 一 些 。 我 们 可 以 重 写 上 面 的 代码 ， 使 
用 非 锁 定 的 手段 ， 如 下 上 所 示 : 


public class ObjectWithValue { 
private AtomicInteger value - new AtomicInteger(0); 


public void incrementValue() { 
value.incrementAndGet(); 


public int getValue() ( 
return value.get(); 
} 
} 





即便 使 用 了 对 象 而 非 直接 操作 ， 使 用 了 
incrementAndGet( ) 这 样 的 信息 发 送 方式 而 非 ++ 操 
作 ， 这 个 类 的 性 能 还 是 几乎 忌 能 胜 过 上 一 版 本 。 在 
某 些 情况 下 只 会 快 一 点 点 ， 但 较 慢 的 情形 却 几 平 不 
存在 。 


怎么 会 这 样 ? 现 代 处 理 器 拥有 一 种 通 弟 称 为 比 
较 交 换 (Compare and Swap, CAS) 的 操作 。 这 种 
操作 类 似 于 数据 库 中 的 乐观 锁定 ， 而 其 同步 版 本 则 
类似 于 保守 锁定 。 


关键 字 synchronized 总 是 要 求 上 锁 ， 即 便 第 二 




















个 线程 并 不 更 新 同一 值 时 也 如 此 。 尽 管 这 种 固有 锁 
的 性 能 一 二 在 提升 ， 但 仍然 代价 郧 贯 。 


非 上 锁 的 版 本 假定 多 个 线程 通常 并 不 频繁 修改 
同一 个 值 ， 导 致 问 题 产生 。 它 高 效 地 侦 测 这 种 情形 
是 否 改 生 ， 并 不 断 尝试 ， 直 至 更 新 成 功 。 这 种 侦 测 
行为 几乎 总 是 比 上 锁 来 得 划算 ， 在 争 用 激烈 的 情况 
下 也 是 如 此 。 


虚拟 机 如 何 实 现 这 种 机 制 ? CAS 的 操作 是 原子 
的 。 逻 辑 上 ，CAS 操 作 看 起 来 像 这 样 : 


int variableBeingSet; 








void simulateNonBlockingSet(int newValue) { 
int currentValue; 
do { 

currentValue - variableBeingSet 
) while(currentValue !- compareAndSwap(currentValue, newValue) 
); 
} 


int synchronized compareAndSwap(int currentValue, int newValue) 


if(variableBeingSet == currentValue) { 
variableBeingSet = newValue; 
return currentValue; 


return variableBeingSet; 


j 





当 某 个 方法 试图 更 新 一 个 共享 变量 ，CAS 操 作 





就 会 验证 要 赋值 的 变量 是 侣 你 有 上 一 次 的 已 知 值 。 
如 果 是 ， 就 修改 变量 值 。 如 果 不 是 ， 则 不 会 碰 变 

量 ， 因 为 另 一 个 线程 正在 试图 更 新 变量 值 。 要 更 新 
数据 的 方法 〈 通 过 CAS 操 作 ) 奏 看 是 含 修改 并 持续 


ASIN S 
A.3.3” 非 线程 安全 类 


有 些 类 天 生 不 是 线程 安全 的 。 下 面 是 几 个 例 
f: 











。 数 据 库 连 接 
e java.util PAY Aas 
e Servlet 


注意 ， 有 些 群 集 类 拥有 一 些 线程 安全 的 方法 。 
不 过 ， 涉 及 调用 多 个 方法 的 操作 都 不 是 线程 安全 
的 。 例 如 ， 如 果 因 为 HashTable 中 已 经 有 某 物 而 不 
打算 答 换 它 ， 可 能 会 写 出 以 下 代码 : 





if(!hashTable.containsKey(someKey)) { 
hashTable.put(someKey, new SomeValue()); 


d 


单个 方法 是 线程 安全 的 。 不 过 ， 另 一 个 线程 却 
可 能 在 containsKey 和 put 调 用 之 间 寨 进 一 个 值 。 有 几 


种 修正 这 个 问题 的 手段 。 


。 先 锁定 HashTable， 确 定 其 他 使 用 者 都 做 了 基于 
客户 闫 的 锁定 : 





synchronized(map) { 
if(!map.conainsKey(key)) 
map.put(key, value); 








。 用 其 对 象 包装 HashTable， 并 使 用 不 同 的 API 
利用 ADAPTER 模 式 做 基于 服务 端的 锁定 : 








public class WrappedHashtable<K, V» { 
private Map«K, V» map = new Hashtable«K, V>(); 


public synchronized void putIfAbsent(K key, V value) { 
if (map.containsKey(key)) 
map.put(key, value); 





。 采 用 线程 安全 的 群集 : 


ConcurrentHashMap<Integer, String» map = new ConcurrentHashMap< 
Integer, String>(); 
map.putIfAbsent(key, value); 








在 java.util.concurrent 中 的 群集 都 有 putIfAbsent( 


) 之 类 提供 这 种 操作 的 方法 。 


AA 方法 之 则 的 依赖 可 能 人 破坏 并 
BARES 
以 下 是 一 个 有 关 在 方法 间 引 入 依赖 的 小 例子 





public class IntegerIterator implements Iterator<Integer> 
private Integer nextValue - 0; 


public synchronized boolean hasNext() (1 
return nextValue « 100000; 


j 


public synchronized Integer next() ( 
if (nextValue -- 100000) 
throw new IteratorPastEndException(); 
return nextValue--*; 


J 


public synchronized Integer getNextValue() { 
return nextValue; 
} 
} 








下 面 是 使 用 Integerlterator 的 代码 : 


IntegerIterator iterator = new IntegerIterator(); 
while(iterator.hasNext()) ( 

int nextValue - iterator.next(); 

// do something with nextValue 


j 





如 果 只 有 一 个 线程 执行 这 段 代 码 ， 不 会 有 什么 
问题 。 但 如 果 有 两 个 线程 抱 着 每 个 线程 都 处 理 它 获 
得 的 值 、 但 列表 中 的 每 个 元 素 都 只 被 处 理 一 次 的 意 
图 ， 尝 试 共 享 Integerlterator 的 单个 实体 ， 会 发 生 什 
AS? 多 数 时 候 什 么 也 不 会 发 生 ， 线 程 开心 地 共享 
AIR, MPF MGR RARE A TORR, TETAS SC 
执行 时 停 下 。 然 而 ， 在 迭代 的 末尾 ， 两 个 线程 也 有 
少量 可 能 互相 干涉 ， 导 致 其 中 一 个 超出 迭代 器 末 
尾 ， 抛 出 异 销 。 


问题 在 这 里 。 线 程 1 调用 hasNext() 方 法 ， 访 方 
法 返回 true。 线 程 1 占 先 ， 然 后 线程 2 也 调用 这 个 方 
法 ， 同 样 返 回 true。 线 程 2 接着 调用 next( )， 该 方法 
如 期 返回 一 个 值 ， 但 副作用 是 之 后 再 调用 hasNext( ) 
融会 返回 false。 线 程 1 继 续 执 行 ， 以 为 hasNext( ) 还 
是 true， 然 后 调用 next( )。 即 便 单个 方法 是 同步 的 ， 
客户 端 还 是 使 用 了 两 个 方法。 


这 的 确 是 个 问题 ， 也 是 并 友 代 码 中 此 类 问题 的 
典型 例子 。 在 这 个 特殊 例子 中 ， 问 题 尤 其 隐蔽 ， 因 
为 只 有 在 达 代 颖 最 后 一 次 迭代 时 发 生 才 会 导致 错 
误 。 如 宋 线 程 刚 好 在 那个 点 中 断 ， 其 中 一 个 线程 束 
FY REE IA NaS ARB IRR ER ETE TE RZ 
后 很 久 才 发 生 ， 而 且 很 难 退 踩 。 


出 现 错误 时 ， 你 有 3 种 做 法 。 























TU H VA; 
。 修改 千 己 代 码 解决 问题 : 基于 和 客 尸 代码 的 锁 
定 ; 





。 修改 服务 端 代码 解决 问题 ， 同 时 也 修改 了 客户 
代码 : 基于 服务 端的 锁定 。 





A.4.1 ACH Œo TH ibe 


有 时 ， 可 以 通过 一 些 设置 让 错误 不 会 导致 损 
害 。 例 如 ， 上 述 客户 代码 可 以 捕捉 并 清理 异常 。 坦 
白地 说 ， 这 有 点 草草 从 事 ， 就 像 是 半夜 重启 解决 内 
存 泄露 问题 一 样 。 


A.4.2 ”基于 客户 代码 的 锁定 


要 让 Integerlterator 在 多 线程 情况 下 正确 运行 ， 
对 客户 代码 做 如 下 修改 : 














IntegerIterator iterator = new IntegerIterator(); 


while (true) { 
int nextValue; 
synchronized (iterator) ( 
if (!iterator.hasNext()) 
break; 
nextValue - iterator.next(); 


} 
doSometingWith(nextValue); 
} 








每 个 客户 端 都 通过 synchronized 关 键 字 引入 一 
个 锁 。 这 种 重复 违反 了 DRY 原 则 ， 但 如 果 代 码 使 用 
非 线程 安全 的 第 三 方 工具 ， 可 能 必须 这 样 做 。 


这 种 策略 有 风险 ， 因 为 使 用 服务 闯 的 程序 员 都 
得 记 住 在 使 用 前 上 锁 、 用 过 后 解锁 。 许 多 《〈 许 
多 ! ) 年 前 ， 我 遇 到 过 一 个 在 共 孚 资源 上 应 用 基于 
客户 代码 锁定 的 系统 。 人 代码 中 有 几 百 处 用 到 这 个 资 
E Uu DNE NNI 
产 锁 定 。 


该 系统 是 个 多 终端 分 时 系统 ， 为 Local 705 卡 车 
司机 联盟 运行 会 计 软 件 。 计 算 机 放 在 距 Local 705 总 
部 50 英 里 〈( 约 84.65km) 以 北 的 一 间 镶 有 高 于 地 面 
的 地 板 、 环 境 可 控 的 机 房 中 。 总 部 有 几 十 位 数据 录 
入 员 ， 往 终端 输入 记录 。 终 端 使 用 电话 专线 和 
600bits 的 半 双 工 调制 解 调 器 连接 到 计算 机 。 (这 可 
是 很 久 很 久 以 前 的 事 了 。 ) 


每 天 大 概 都 会 有 一 台 终 闪 坚 无 理由 地 “ 死 锁 ”。 
BEALE AS BR FE TEAC EES ig RE EA TA]. REA A 
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来 很 不 便 。 我 们 得 打 电 话 给 总 部 ， 让 大 家 都 完成 在 

















终 闹 上 的 工作 。 然 后 我 们 才能 天机、 重启。 如果 有 
人 在 做 要 论 上 一 两 个 小 时 才能 做 完 的 事 ， 被 锁定 的 
终 问 束 只 能 一 二 等 看 。 


经 过 几 个 星期 的 调试 ， 我 们 用 现 ， 原 因 在 于 一 
个 指针 不 同步 的 环形 缓冲 区 计数 项 。 该 缓冲 区 控制 
问 终 站 的 得 出。 指针 值 资 明 缓 冲 区 是 衬 的 ， 但 计数 
器 却 指出 缓冲 区 是 满 的 。 因 为 缓冲 区 是 空 的 ， 就 没 
什么 可 显示 ; 但 因为 缓冲 区 也 是 满 的 ， 也 就 无 法 加 
其 中 加 入 可 在 屏 妖 上 显示 的 内 容 。 


我 们 知道 了 终端 为 何 会 死 锁 ， 但 却 不 知道 为 什 
么 坏 形 缓冲 区 会 不 同步 。 我 们 用 了 后 手 段 发 现 问 题 
所 在 。 当 时 程序 能 够 恋 取 计算 机 的 前 面板 开关 状态 
(这 可 是 很 久 很 久 以 前 的 事 了 〉。 我 们 写 了 个 陷阱 
程序 ， 侦 测 这 些 开 关 何 时 被 拨 动 ， 然 后 查找 既 空 又 
满 的 环形 绥 冲 区 。 如 来 找到 ， 束 草 置 该 绥 冲 区 为 
ZR. Bh! 锁定 的 终端 又 重新 开始 显示 了 。 


这 样 ， 在 终 站 锁定 时 就 不 必 重 司 系统 了 。 客 户 
只 需要 打 电 话 告诉 我 们 出 现 死 锁 ， 我 们 就 径直 走 到 
机 房 ， 拨 动 一 下 开关 即 可 。 

当然 ， 有 时 他 们 会 在 周末 加 班 ， 但 是 我 们 可 不 


加 班 。 所 以 我 们 又 在 计划 列表 中 添加 了 一 个 函数 ， 
每 分 钟 检 查 一 次 全 部 环形 缓冲 区 ， 重 置 既 空 叉 满 的 


























绥 冲 区 。 在 客户 打 电 话 之 前 ， 显 示 束 已 经 恢复 正常 
了 了。 





在 用 现 问题 原因 之 前 ， 我 们 伦 了 好 几 个 星期 得 
看 一 页 又 一 页 的 单片机 汇编 语言 代码 。 我 们 已 经 完 
成 计算 ， 算出 死 锁 的 频率 是 周期 性 的 ， 而 且 其 中 有 
一 处 未 党 保护 的 环形 缓冲 区 使 用 。 所 以 ， 剩 下 的 任 
务 融和 是 找 出 那个 错误 的 用 法 。 不 竺 这 是 多 年 以 前 的 
事 ， 那 时 既 没 有 搜索 工具 ， 也 没有 交叉 引用 或 任何 
其 他 目 动 化 帮助 手段 。 我 们 只 能 细 碍 代码 清单 。 


在 芝加哥 1971 年 的 寒冬 ， 我 学 到 了 重要 的 一 
课 。 基 于 客户 代码 的 锁定 实在 不 可 靠 。 


A.4.3 基于 服务 问 的 锁定 


按照 以 下 方式 修改 Integerlterator 也 能 消除 重 





public class IntegerIteratorServerLocked { 
private Integer nextValue = 0; 
public synchronized Integer getNextOrNull() { 
if (nextValue « 100000) 


return nextValuet+; 
else 
return null; 
} 
} 





客户 代码 也 要 修改 : 


while (true) { 
Integer nextValue - iterator.getNextOrNull(); 
if (next -- null) 
break; 


// do something with nextValue 


j 





在 这 种 情形 下 ， 我 们 实际 上 有 是 修改 了 类 的 
API， 使 其 能 适应 多 线程 B 。 客 户 端 需要 做 null 检 
查 ， 而 不 是 检查 hasNext( )。 





通 疝 你 应 该 选用 基于 服务 器 的 锁定 ， 因 为 : 


它 减 少 了 重复 代码 一 一 采用 基于 客户 代码 的 锁 
定 ， 每 个 客户 端 都 要 正确 锁定 服务 端 。 把 锁定 
代码 放 到 服务 闫 ， 客 户 端 就 能 目 由 使 用 对 象 ， 
不 必 费 心 编写 额外 的 锁定 代码 ; 

它 提升 了 性 能 一 一 在 单线 程 部 署 中 ， 可 以 用 非 
Be REEL EARS tit VS SARA EZ EP tg 
从 而 省 去 花 销 ; 

它 减少 了 出 错 的 可 能 性 
bs iu Ei ; 

EIT T ER ANA — V SRB FR ERS VAX — 
处 地 方 实施 ， 而 不 是 在 许多 地 方 〈 每 个 客户 
wid) 实施 ; 











只 会 有 一 个 程序 员 











。 瑟 绾 减 了 共 平 变量 的 作用 范围 一 一 客户 疹 不 必 
天 心 它 们 或 它们 是 如 何 锁定 的 。 一 切 都 隐藏 在 
服务 闪 。 如 条 出 错 ， 要 侦 碍 的 范围 吏 小 多 了 。 

如 和 你 无 法 修改 服务 中 代码 又 该 如 何 ? 


。 使 用 ADAPTER 模 式 修 改 API， 添 加 锁定 ; 








public class ThreadSafeIntegerIterator ( 
private IntegerIterator iterator - new IntegerIterator(); 


public synchronized Integer getNextOrNull() { 
if(iterator.hasNext()) 
return iterator.next(); 
return null; 


j 
4 








。 更 好 的 方法 是 使 用 线程 安全 的 群集 和 扩展 接 
Ll. 


AS 近 升 在 吐 量 


假设 我 们 打算 连接 上 网 ， 从 一 个 URL 列 表 中 读 
取 一 组 页 面 的 内 容 。 读 到 一 个 页 面 时 ， 解 析 该 页 面 
并 得 到 一 些 统计 结果 。 读 完 所 有 页 面 后 ， 打 印 出 一 
份 提要 报表 。 


下 面 的 类 返回 给 定 URL 的 页 面 内 容 : 





public class PageReader { 
Z3 
public String getPageFor(String url) ( 
HttpMethod method = new GetMethod(url); 


try { 
httpClient.executeMethod(method); 
String response - method.getResponseBodyAsString(); 
return response; 


) catch (Exception e) ( 
handle(e); 

) finally ( 
method.releaseConnection(); 
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public class PageIterator { 
private PageReader reader; 


private URLIterator urls; 


public Pagelterator(PageReader reader, URLIterator urls) { 
this.urls - urls; 
this.reader - reader; 


j 


public synchronized String getNextPageOrNull() { 
if (urls.hasNext()) 
getPageFor(urls.next()); 
else 
return null; 


j 


public String getPageFor(String url) { 
return reader.getPageFor(url); 
} 
} 





Pagelterator 的 一 个 实体 可 为 多 个 不 同 线程 共 
享 ， 每 个 线程 使 用 自己 的 PageReader 实 体 读 取 并 解 
析 从 迭代 器 中 得 到 的 页 面 。 


注意 ， 我 们 把 synchronized 代 码 块 的 数量 限制 
在 小 范围 之 内 。 它 只 包括 深 处 于 Pagelterator 内 部 的 
临界 区 。 最 好 是 尽 可 能 少 地 使 用 同步 。 


A.5.1 FAZER BA Seth 
来 做 个 简单 计算 。 鉴 于 讨论 的 目的 ， 假 定 : 
。 获 取 一 个 页 面 的 VO 时 间 (平均 ) 是 1s; 


e 解析 一 个 页 面 的 处 理 时 间 “〈 平 均 ) 是 0.5s; 
。1O 操 作 不 耗费 处 理 器 能 力 ， 而 解析 页 面 耗费 
100% 处 理 器 能 
对 于 单个 线程 要 处 理 的 N 个 页 面 ， 总 的 执行 时 
间 为 1.5s*N。 图 A-1 显 示 了 13 个 页 面 或 大 概 19.5s 的 
快照 。 


单线 程 


解析 页 面 [| [| [LJ] [| [LJ] [| [LJ] [| [LJ] 


获得 页 面 





图 A-1 单线 程 


A.5.2 ”多 线程 条 件 下 的 吞吐 量 


如 于 能 够 以 任意 次 序 获得 页 面 并 独立 处 理 页 
面 ， 残 有 可 能 利用 多 线程 提升 吞吐 量 。 如 果 我 们 使 
用 三 个 线程 会 如 何 ? 在 同一 时 间 内 能 获取 多 少 个 页 
ve? 


BUY ERIA-2'* ATUL, RIEN SSP 3 Wh Bas 
能 力 有 关 的 页 面 解析 操作 可 以 和 与 WO 有 关 的 页 面 
读 取 操作 盖 加 进行 。 在 理想 状态 下 ， 这 意味 着 处 理 
aa JARI. BES ERY — A BEES ESE ERE Ab 
两 次 解析 操作 钱 加 进行 。 这 样 ， 我 们 就 能 在 每 秒 钟 























内 处 理 两 个 页 面 ， 即 三 们 于 单线 程 方案 的 硬 吐 量 。 


线程 1 


解析 页 面 [| AI [1 [| [1 T] [1 [| AI [| fl 


获得 页 面 LLLLLLLILLLLUI 


线程 2 


解析 页 面 | | | | | | | | | TI 


获得 页 面 LLLILIILIIIDDDDDLD 


线程 3 


解析 页 面 | ] | ] | | ] | | ] [LII [| | | | 


AGH LLLELELi tite t itt itt ei tet ttt 


图 A-2 三 个 并 发 线程 


A.6 "tg 


想象 一 个 拥有 两 个 有 限 共有 至 资 源 池 的 Web 应 用 
程序 。 


。 一 个 用 于 本 地 临时 工作 存储 的 数据 库 连 接 池 ; 
。 一 个 用 于 连接 到 主 存储 库 的 MQ 池 。 


假定 该 应 用 中 有 两 个 操作 : 创建 和 更 新 。 


e 创建 一 一 获取 到 主 存 储 库 和 数据 库 的 连接 。 与 
主 存储 库 协 调 ， 并 把 工作 保存 到 本 地 临时 工作 
数据 库 ; 

e 更 新 一 一 先 获 取 到 数据 库 的 连接 ， 表 获取 到 主 
存储 库 的 连接 。 从 临时 工作 数据 库 中 读 取 数 
据 ， 和 再 发 送 给 主 存储 库 。 


如 果 用 户 数量 多 于 凶 的 大 小 会 怎样 ? 假设 每 个 
闻 中 能 容纳 10 个 资源 。 


。 有 10 个 用 户 和 尝试 创 建 ， 获 取 了 10 个 数据 库 连 
接 ， 每 个 线程 在 获取 到 数据 库 连 接 之 后 、 获 取 
到 主 存储 库 连 接 之 前 都 被 打 断 ; 

。 有 10 个 用 户 笠 试 更 新 ， 获 取 了 10 个 主 存储 库 连 
接 ， 每 个 线程 在 获取 到 主 存储 库 连接 之 后 、 获 




















取 到 数据 库 连 接 之 前 部 会 被 打 靳 ; 

。 现 在 那 10 个 “创建 ?线程 必须 等 竺 获取 主 存储 库 
连接 ， 但 那 10 个 “更 新 ”线程 必须 等 待 获 取 数 据 
库 连 接 ; 

。 死 锁 。 系 统 永远 无 法 恢复 。 


这 听 起 来 不 太 会 出 现 ， 但 谁 会 想 要 一 个 每 隔 一 
周 融 僵 在 那里 不 动 的 系统 呢 ? 谁 想 要 调试 出 现 了 难 
以 复 现 的 症状 的 系统 呢 ? 这 种 问题 突然 友 生 ， 然 后 
得 化 上 好 几 个 星期 才能 解决 。 


典型 的 “ 解 诀 方 案 ” 是 加 入 调试 语句 ， 发 现 问 
题 。 当 然 ， 调 试 语 句 对 代码 的 修改 足以 令 死 锁 在 不 
同情 况 下 发 生 ， 而 且 要 几 个 月 后 才 会 再 出 现 网 。 


要 真正 地 解决 死 锁 问 题 ， 我 们 需要 理解 死 锁 的 
原因 。 死 锁 的 发 生 需要 4 个 条 件 : 
e AR; 
。 上 锁 及 等 待 ; 
。 无 抢先 机 制 ; 
© 循环 等 符 。 


A.6.1 EJF 


当 多 个 线程 需要 使 用 同一 资源 ， 且 这 些 资源 满 





足下 列 条 件 时 ， 互 斥 融会 及 生 。 


。 无 法 在 同一 时 间 为 多 个 线程 所 用 ; 
。 数量 上 有 限制 。 


这 种 资源 的 第 见 例子 是 数据 库 连 接 、 打 开 后 用 
于 写 入 的 文件 、 记 录 锁 或 是 信号 量 。 


A.6.2 上 锁 及 等 竺 


当 某 个 线程 获取 一 个 资源 ， 在 获取 到 其 他 全 部 
所 需 资 源 并 完成 其 工作 之 前 ， 不 会 释放 这 个 资源 。 


A.6.3 无 抢先 机 制 
线程 无 法 从 其 他 线程 处 夺取 资源 。 一 个 线程 持 


有 资源 时 ， 其 他 线程 获得 这 个 资源 的 唯一 手段 就 是 
等 待 该 线程 释放 资源 。 


A.6.4 循环 等 行 


这 也 被 称 为 “死命 拥抱 >。 想象 两 个 线程 ，T1 和 
T2， 还 有 两 个 资源 ，R1 和 R2。T1 拥 有 R1，T2 拥 有 
R2。T1 需 要 R2，T2 需 要 R1。 如 此 就 出 现 了 如 图 A-3 
所 示 的 情形 。 




















这 4 种 条 件 都 是 死 锁 押 必 需 的 。 只 要 其 中 一 个 
不 满足 ， 死 锁 束 不 会 友 生 。 
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图 A-3 ”循环 等 行 


A.6.5 AEF 


避 倪 死 锁 的 一 种 束 略 是 规避 互 斥 条 件 。 你 可 
以 : 


e 使 用 允许 同时 使 用 的 资源 ， 如 AtomicInteger: 
。 增 加 资源 数量 ， 使 其 等 于 或 大 于 苋 争 线程 的 数 


三 | 


LL 


FE 
EKA, maces. 


不 钼 的 是 ， 多 数 资 源 部 有 上 限 ， 且 不 能 同时 使 
用 。 而 且 第 二 个 资源 的 标识 也 党 第 要 依据 对 第 一 个 
资源 的 操作 结果 来 判断 。 不 过 别 丧 气 ， 还 有 3 个 其 
他 条 件 呢 。 


A.6.6 不 上 锁 及 等 待 


如 果 拒 绝 等 待 ， 了 束 能 消除 死 锁 。 在 获得 资源 之 
MRAR, WREEK, WENA 
资源 ， 重 新 来 过 。 


这 种 手段 市 来 几 个 潜在 问题 : 


e Zeke Lh 某 个 线程 一 直 无 法 获得 它 所 需 的 
资源 ( 它 可 能 需要 某 种 很 少 能 同时 获得 的 资源 
组 合 ) ; 

yeh 几 个 线程 可 能 会 前 后 相连 地 要 求 获 得 
某 个 资源 ， 然 后 再 释放 一 个 资源 ， 如 此 循环 。 
这 在 单纯 的 CPU 任务 排列 算法 中 尤其 有 可 能 
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CPU 利用 率 低 ， 第 二 个 的 结果 是 较 高 但 无 用 的 CPU 
利用 率 。 


尽 党 这 种 策略 听 起 来 没 效 率 ， 但 也 好 过 没有 。 
人 至少， 如 条 其 他 方案 不 故 效 ， 这 种 手段 几乎 总 可 以 
用 上 。 


A.6.7 ”满足 抢先 机 制 


避免 死 锁 的 邦 一 策略 是 允许 线程 从 其 他 线程 上 
夺取 资源 。 这 通常 利用 一 种 简 蛙 的 请 求 机 制 来 实 
Mo SATE RCRA, BORE a 
Zo WIR ATES AUR, MEENE 
源 并 重新 来 过 。 

这 和 上 一 种 手段 相似 ， 但 好 处 是 允许 线程 等 待 
资源 。 这 减少 了 线程 重新 局 动 的 次 数 。 不 过 ， 管 理 
所 有 请 求 可 要 伦 点 心思 。 


A.6.8 META SETS 


这 是 避免 死 锁 的 最 第 用 手段 。 对 于 多 数 系统 ， 
它 只 要 求 一 个 为 各 方 认 同 的 约定 。 


在 上 面 的 例子 中 线程 1 同时 需要 资源 1 和 资源 
2、 线 程 2 同时 需要 资源 2 和 资源 1， 只 要 强制 线程 1 
































和 线程 2 以 同样 次 序 分 配 资源 ， 循 环 等 待 就 不 会 发 
"E. 


普通 地 ， 如 果 所 有 线程 都 认同 一 种 资源 获取 
次 序 ， 并 按照 这 种 次 序 获取 资源 ， 死 锁 束 不 会 友 
生 。 束 像 其 他 策略 一 样 ， 这 也 会 有 问题 : 


。 获 取 资 源 的 次 序 可 能 与 使 用 资源 的 次 序 不 匹 
Bc; 一 开始 获取 的 资源 可 能 在 最 后 才 会 用 到 。 
这 可 能 导致 资源 不 必要 地 被 长 时 间 锁 定 ; 

。 有 时 无 法 强求 资源 获取 顺序 。 如 果 第 二 个 资源 
的 ID 来 自 对 第 一 个 资源 操作 的 结果 ， 获 取 次 序 
也 无 从 谈 起 。 

ALVES EER TT. ALS SAR, 5 

外 一 些 会 导致 对 CPU 能 力 的 大 量 耗费 和 降低 啊 应 

率 。TANSTAAFL 5! ! 


将 解决 方案 中 与 线程 相关 的 部 分 分 隅 出 来 ， 再 
加 以 调整 和 试验 ， 是 获得 判断 最 佳 集 略 所 需 的 洞 见 
的 正道 。 








A.7 测试 多 线程 代码 
怎么 才能 编写 显示 以 下 代码 有 错 的 测试 呢 ? 


: public class ClassWithThreadingProblem { 
int nextId; 


public int takeNextId() { 
return nextId++; 


j 


g 





下 和 面 是 对 能 证 明 上 列 代 码 有 和 错 的 测试 的 摘 述 : 


。 记 住 nextId 的 当前 值 ; 

。 创建 两 个 线程 ， 每 个 都 调用 takeNextId( ) 一 次 ; 

e 验证 nextId 比 开始 时 大 2; 

。 持续 运行 ， 直 至 发 现 nextId 只 比 开 始 时 大 1 为 
ee 


代码 清单 A-2 展 示 了 这 样 一 个 测试 : 


代码 清单 A-2 ClassWithThreadingProblemTest.java 





01: package example; 


03: import static org.junit.Assert.fail; 


05: import org.junit.Test; 


06: 
07: public class ClassWithThreadingProblemTest { 
08: QTest 


09: public void twoThreadsShouldFailEventually() throws Excep 
tion ( 
10: final ClassWithThreadingProblem classwithThreadingProbl 
em 
= new ClassWwithThreadingProblem(); 
11: 
12; Runnable runnable - new Runnable() ( 
13: public void run() { 
14: classwithThreadingProblem.takeNextId(); 
T5: } 
16: }; 
17: 
18: for (int i = 0; i < 50000; ++i) { 
19: int startingId = classWithThreadingProblem.lastId; 
20: int expectedResult = 2 + startingId; 
21: 
22: Thread t1 = new Thread(runnable); 
23: Thread t2 = new Thread(runnable); 
24: ti.start(); 
25: t2.start(); 
26: t1.join(); 
27: t2.join(); 
28: 
29: int endingId = classWithThreadingProblem.lastId; 
30: 
31: if (endingId != expectedResult) 
32: return; 
33: } 
34: 
35: fail("Should have exposed a threading issue but it 
did not."); 
36: } 
37: ) 





表 A-3 代码 清单 A-2 的 注解 












































创建 ClassWithThreadingProblem 的 单个 实体 。 注 意 ， 必 须 使 用 final 关 键 字 ， 因 为 要 在 一 
匿名 内 部 类 中 用 到 它 












































创建 一 个 匿名 内 部 类 ， 该 类 用 到 ClassWithThreadingProblem 的 单个 

















运行 这 段 代码 “足够 多 ”次 以 展示 代码 失败 ， 但 不 要 多 到 “ 花 太 长 时 间 ”。 这 是 种 平衡 行 
en 选择 这 个 数字 有 点 难 尽管 我 们 箱 语 会 看 到 能 够 极 大 地 降 代 
这 字 



























































记 住 开始 时 的 值 。 这 个 测试 试图 证 明 ClassWithThreadingProblem 中 的 代码 有 错误 。 如 
果 测 试 通过 ， 它 就 证 明了 这 一 点 。 如 果 测 试 失败 ， 它 就 没 能 证 明代 码 出 错 






















































































创建 两 个 线程 ， 都 使 用 我 们 在 第 12~16 行 创建 的 对 象 。 这 样 两 个 线程 就 有 可 能 用 
ClassWithThreadingProblem 的 单个 实体 ， 互 相干 涉 























两 个 线程 









































一 样 ? 如 果 是 ， 测 试 结束 一 一 我 们 已 经 证 明了 代码 有 错误 。 如 





























到 达 这 一 步 ， Mp CERE UR 范围 > 的 时 间 内 出 错 ; 测试 失败 了 。 要 么 
是 代码 没 错 ， 要 么 是 没有 运行 足够 多 次 ， 错 误 条 件 还 没 满足 





























这 个 测试 当然 设置 了 满足 并 发 更 新 问题 友 生 的 
At. DR, MRA UM, MRA 
可 能 侦 测 不 到 。 


实际 上 ， 要 真正 侦 测 到 问题 ， 需 要 将 循环 数量 
设置 到 100 万 次 以 上 。 即 便 是 这 样 ， 在 10 个 100 万 次 
循环 的 执行 中 ， 错 误 也 只 发 生 了 一 次 。 这 意味 着 我 
们 可 能 要 把 循环 次 数 设 置 为 超过 亿 次 才能 获得 可 靠 
的 失败 证 明 。 要 等 多 久 呢 ? 


即便 我 们 调 优 测试 ， 在 单 台 机 器 上 得 到 可 靠 的 
失败 证 明 ， 我 们 可 能 还 需要 用 不 同 的 值 来 重新 设置 
测试 ， 得 到 在 其 他 机 器 、 操 作 系 统 或 不 同 版 本 的 
JVM 上 的 失败 证 明 。 

而 且 这 只 是 个 简单 问题 。 如 果 连 这 个 简单 问 
题 都 无 法 轻易 获得 出 错 证 明 ， 我 们 怎么 能 真正 侦 测 
复杂 问题 呢 ? 

我 们 能 用 什么 手段 来 证 明 这 个 简单 错误 呢 ? 而 
用， 更 重要 的 是 ， 我 们 如 何 能 写 出 证 明 更 复杂 代码 
中 的 错误 的 测试 呢 ? 我 们 怎样 才能 在 不 知道 从 何 处 
着 手 时 知道 代码 是 否 出 错 了 呢 ? 


下 面 是 一 些 想法 : 


e AUN RiBaMiX . 。 训 试 要 有 灵活， 便于 调整 。 多 次 























运行 测试 一 一 在 一 台 测 斌 服务器 上 一 一 随机 改 
变调 整 值 。 如 采 测 试 失 败 ， 代 码 就 有 错 。 确 保 
及 早 编 写 这 些 测 试 ， 好 让 持续 集成 服务 器 尽快 
开始 运行 测试 。 另 外 ， 确 认 小 心 记录 了 在 何 种 
条 件 下 测试 失败 。 
在 每 种 目标 部 普 平 台 上 运行 测试 。 重 复 运 行 。 
持续 运行 。 测 试 在 不 失败 的 前 提 下 运行 得 越 
A, BUB DLE]: 

o 生产 代码 正确 ; 

或 

o 测试 不 足以 暴露 问题 。 
在 另 一 台 有 不 同 负载 的 机 右上 运行 测试 。 能 模 
拟 生 产 环 境 的 负载 ， 束 模拟 之 。 
即便 你 做 了 所 有 这 些 ， 还 是 不 见得 有 很 好 的 机 
会 友 现 代码 中 的 线程 问题 。 最 阴险 的 问题 拥有 
很 小 的 截面 ， 在 十 亿 次 执行 中 只 会 友 生 一 次 。 
这 类 错误 是 复杂 系统 的 豆 梦 。 

















A.8 测试 线程 代码 的 工具 支持 


IBM 提 供 了 一 个 名 为 ConTest 的 工具 16] 。 它 能 
对 类 进行 装置 ， 令 非 线 程 安全 代码 更 有 可 能 失败 。 





我 们 与 BM 或 开发 ConTest 的 团队 没有 直接 关 
系 。 有 位 同事 发 现 了 这 个 工具 。 在 用 了 几 分 钟 后 ， 
我 们 发 现 目 己 发 现 线程 问题 的 能 力 得 到 了 很 大 提 








下 面 是 使 用 ConTest 的 简要 步骤 : 


。 编 写 测试 和 生产 代码 ， 确 保有 专门 模拟 多 用 户 

在 多 种 负载 情况 下 操作 的 测试 ， 如 上 文 所 述 ; 
。 用 ConTest 装 置 测试 和 生产 代码 ; 
e 运行 测试 。 

用 ConTest 装 置 代码 后 ， 原 本 于 万 次 循环 才能 

骏 露 一 个 错误 的 比率 提升 到 30 次 循环 就 能 找到 错 
误 。 以 下 是 装置 代码 后 的 儿 次 测试 运行 结果 值 : 
13. 23. 0. 54. 16. 14. 6. 69. 107. 494812, X 
RE A a SS SECURE 4 RU n] Sed AE Bj] AA: o 





AQ 小 结 


本 章 只 是 在 并 发 编程 广阔 而 可 怕 的 领地 上 的 短 
OGRA. BA ARR ihe. Be E 
的 ， 只 是 保持 并 友 代 人 码 整 洁 的 一 些 规 程 ， 如 果 要 编 
写 并 发 系统 ， 还 有 许多 东西 要 学 。 建 议 从 Doug Lea 
的 大 作 Concurrent Programming in Java: Design 
Principles and Patterns 开始 V1 。 


在 本 章 中 ， 我 们 谈 到 并 发 更 新 ， 还 有 清理 及 如 
免 同步 的 规程 。 我 们 谈 到 线程 如 何 提 升 与 WO 有 关 
的 系统 的 厨 吐 量 ， 展 示 了 获得 这 种 提升 的 整 洲 技 
术 。 我 们 谈 到 死 锁 及 王 疤 地 避免 死 锁 的 规程 。 最 
后 ， 我 们 谈 到 通过 凌 置 代码 雄 露 并 友 问 题 的 集 略 。 











A.10 教程: 完整 代码 范例 
A.10.1 客户 端 /服务 器 非 线 程 代码 


代码 清单 A-3 Server.java 





package com.objectmentor.clientserver.nonthreaded; 


import java.io.IOException; 
import java.net.ServerSocket; 
import java.net.Socket; 

import java.net.SocketException; 


import common.MessageUtils; 


public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing - true; 


public Server(int port, int millisecondsTimeout) throws IOExce 
ption ( 
serverSocket - new ServerSocket(port); 
serverSocket.setSoTimeout(millisecondsTimeout); 


j 


public void run() { 
System.out.printf("Server Starting\n"); 


while (keepProcessing) { 

try { 
System.out.printf("accepting client\n"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process(socket); 

) catch (Exception e) ( 
handle(e); 


j 


private void handle(Exception e) ( 
if (!(e instanceof SocketException)) { 
e.printStackTrace(); 
} 
} 


public void stopProcessing() { 
keepProcessing = false; 
closelgnoringException(serverSocket); 


j 


void process(Socket socket) { 
if (socket -- null) 
return; 


try { 
System.out.printf("Server: getting message\n"); 


String message - MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 

} catch (Exception e) { 
e.printStackTrace(); 

} 

} 


private void closeIgnoringException(Socket socket) { 
if (socket !- null) 
try { 
socket.close(); 
) catch (IOException ignore) { 
} 
} 


private void closeIgnoringException(ServerSocket serverSocket) 


if (serverSocket !- null) 
try { 
serverSocket.close(); 
) catch (IOException ignore) { 


代码 清单 A-4 ClientTest.java 





package com.objectmentor.clientserver.nonthreaded; 


import java.io.IOException; 
import java.net.ServerSocket; 
import java.net.Socket; 

import java.net.SocketException; 


import common.MessageUtils; 


public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing - true; 
public Server(int port, int millisecondsTimeout) throws IOExce 
ption ( 
serverSocket - new ServerSocket(port); 
serverSocket.setSoTimeout(millisecondsTimeout); 


j 


public void run() { 
System.out.printf("Server Starting\n"); 


while (keepProcessing) { 

try { 
System.out.printf("accepting client\n"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process(socket); 

) catch (Exception e) ( 
handle(e); 


private void handle(Exception e) ( 
if (!(e instanceof SocketException)) { 
e.printStackTrace(); 


j 
j 


public void stopProcessing() (1 
keepProcessing - false; 
closelgnoringException(serverSocket); 


j 


void process(Socket socket) { 
if (socket -- null) 
return; 


try { 
System.out.printf("Server: getting message\n"); 
String message - MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closelgnoringException(socket); 

) catch (Exception e) ( 
e.printStackTrace(); 


j 
j 


private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 
) catch (IOException ignore) { 


j 
j 


private void closeIgnoringException(ServerSocket serverSocket) 


i 


if (serverSocket !- null) 
try { 
serverSocket.close(); 
) catch (IOException ignore) ( 





代码 清单 A-5  MessageUtils.java 


package common; 


import java.io.IOException; 

import java.io.InputStream; 

import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 
import java.io.OutputStream; 
import java.net.Socket; 


public class MessageUtils ( 
public static void sendMessage(Socket socket, String message) 
throws IOException { 
OutputStream stream = socket.getOutputStream(); 


ObjectOutputStream oos = new ObjectOutputStream(stream) ; 
oos.writeUTF(message); 
oos.flush(); 


j 


public static String getMessage(Socket socket) throws IOExcept 
ion ( 
InputStream stream = socket.getInputStream(); 
ObjectInputStream ois = new ObjectInputStream(stream) ; 
return ois.readUTF(); 


j 
j 





A.10.2 ”使 用 线程 的 客户 端 /服务 器 代码 


把 服务 堪 修 改 为 使 用 多 线程 ， 只 需要 对 处 理 消 
娠 进行 修改 即 可 (新 的 代码 行 用 粗 体 标 出 〉: 








void process(final Socket socket) { 
if (socket == null) 
return; 


Runnable clientHandler = new Runnable() { 


public void run() { 


try i 
System.out.printf("Server: getting message\n"); 
String message - MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message) 
MessageUtils.sendMessage(socket, "Processed: " + message) 
System.out.printf("Server: sent\n"); 


closelgnoringException(socket); 
) catch (Exception e) ( 
e.printStackTrace(); 


H 


Thread clientConnection - new Thread(clientHandler); 


clientConnection.start(); 





[1] W: 
码 。 复 查 前 文 的 非 多 线程 代码 。 复 查 之 后 的 多 线程 
代码 。 





你 可 以 目 行 验证 修改 之 前 和 之 后 的 代 


[2] JRE: 这 说 得 有 乓 简单 了 。 鉴 于 讨论 的 目 
的 ， 我 们 就 用 这 个 简化 模型 好 了 。 


[3] E: 实际 上 ，Iterator 接 口 天 生 不 是 线程 安 
全 的 。 它 并 不 为 多 线程 而 设计 ， 所 以 出 现 这 种 情况 
也 不 奇怪 。 


[4] JRE: 例如 ， 有 人 添加 了 一 些 调试 输出 ， 问 
题 “ 不 见 了 ”。 调 试 代码 “修正 ”了 问题， 其 实 问题 还 
在 系统 中 存在 。 


[5] JRVE: 世上 没有 免费 的 午餐 (There ain't no 
such thing as a free lunch) 。 








[6] 原 


注 : http://www.haifa.ibm.com/projects/verification/coi 


[7] Jk: WL[Lea99]p.191. 


附录 B org.jfree.date.SerialDate 


代码 清单 B-1 SerialDate.Java 





2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * es cas ees ae UU as Ss UNT CVM NE CU es CENE UU CUT NP CV as E CiU cv NR ee oup cer ee ee a rca fcrc ir um reri en mw racc cr e ra prm] 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 


8 * 
9 * This library is free software; you can redistribute it 
and/or modify it 
10 * under the terms of the GNU Lesser General Public Licens 
e as published by 
11 * the Free Software Foundation; either version 2.1 of the 
License, or 
12 * (at your option) any later version. 
13- * 
14 * This library is distributed in the hope that it will be 
useful, but 
15 * WITHOUT ANY WARRANTY; without even the implied warranty 
of MERCHANTABILITY 
16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser 
General Public 
17 * License for more details. 
18 * 
19 * You should have received a copy of the GNU Lesser Gener 
al Public 
20 * License along with this library; if not, write to the F 
ree Software 
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Bost 
on, MA 02110-1301, 


22 * USA. 
23 * 


24 * [Java is a trademark or registered trademark of Sun Mic 


rosystems, Inc. 


25 * in the United States and other countries.] 


26 
21 
28 


30 
31 
32 
mited); 
33 * 
34 * 
35 * 
Exp $ 
36 
37 
38 
39 11-Oct-2001 
w package 
40 * 
41 * 05-Nov-2001 
inated NotableDate 
42 c 
43 * 12-Nov-2001 
that NotableDate 
44 * 
ayOfWeek(), 
45 * 
OfWeek() to correct 
46 * 
47 * 05-Dec-2001 
48 * 29-May-2002 
interface 
49 * 
50 * 27-Aug-2002 


+ + + o 


o N???levka Petr (DG); 


51 * 03-Oct-2002 
52 * 13-Mar-2003 
53 * 29-May-2003 
54 * 04-Sep-2003 
Range javadocs (DG); 
55 * 05-Jan-2005 


* 
* 
* 
JOI Ecc cba 
* 
* 
* 


(C) Copyright 2001-2005, by Object Refinery Limited. 
Original Author: David Gilbert (for Object Refinery Li 
Contributor(s): =} 


$Id: SerialDate.java,v 1.7 2005/11/03 09:25:17 mungady 


Changes (from 11-Oct-2001) 


Re-organised the class and moved it to ne 


com.jrefinery.date (DG); 


: Added a getDescription() method, and elim 


Class (DG); 
IBD requires setDescription() method, now 


class is gone (DG); Changed getPreviousD 
getFollowingDayOfWeek() and getNearestDay 
bugs (DG); 

Fixed bug in SpreadsheetDate class (DG); 


Moved the month constants into a separate 


(MonthConstants) (DG); 
Fixed bug in addMonths() method, thanks t 


Fixed errors reported by Checkstyle (DG); 
Implemented Serializable (DG); 

Fixed bug in addMonths method (DG); 
Implemented Comparable. Updated the isIn 


Fixed bug in addYears() method (1096282) 


(DG); 


56 * 

bg 

58 

59 package org.jfree.date; 
60 


61 import java.io.Serializable; 

62 import java.text.DateFormatSymbols; 

63 import java.text.SimpleDateFormat; 

64 import java.util.Calendar; 

65 import java.util.GregorianCalendar; 

66 

67 /** 

68 * An abstract class that defines our requirements for ma 
nipulating dates, 

69 * without tying down a particular implementation. 

70 * <P> 

71 * Requirement 1 : match at least what Excel does for dat 


72 * Requirement 2 : class is immutable; 

73 * <P> 

74 * Why not just use java.util.Date? We will, when it mak 
es sense. At times, 

75 * java.util.Date can be *too* precise - it represents an 
instant in time, 

76 * accurate to 1/1000th of a second (with the date itself 
depending on the 

77 * time-zone). Sometimes we just want to represent a par 
ticular day (e.g. 21 

78 * January 2015) without concerning ourselves about the t 
ime of day, or the 

79 * time-zone, or anything else. That's what we've define 
d SerialDate for. 

80 * <P> 

81 * You can call getInstance() to get a concrete subclass 
of SerialDate, 

82 * without worrying about the exact implementation. 

83 * 

84 * Qauthor David Gilbert 


85 */ 

86 public abstract class SerialDate implements Comparable, 

87 Serializable, 
88 MonthConstants 


89 


90 /** For serialization. */ 


91 private static final long serialVersionUID - -29371604 
0467423637L; 

92 

93 /** pate format symbols. */ 

94 public static final DateFormatSymbols 

95 DATE FORMAT SYMBOLS - new SimpleDateFormat().getDa 
teFormatSymbols(); 

96 

97 /** The serial number for 1 January 1900. */ 

98 public static final int SERIAL LOWER BOUND - 2; 

99 

100 /** The serial number for 31 December 9999. */ 

101 public static final int SERIAL UPPER BOUND - 2958465; 
102 

103 /** The lowest year value supported by this date forma 
p 5v. 

104 public static final int MINIMUM YEAR SUPPORTED - 1900; 
105 

106 /** The highest year value supported by this date form 
at. */ 

107 public static final int MAXIMUM YEAR SUPPORTED - 9999; 
108 

109 /** Useful constant for Monday. Equivalent to java.uti 
l.Calendar.MONDAY. */ 

110 public static final int MONDAY - Calendar.MONDAY; 

111 

112 TEE 

113 * Useful constant for Tuesday. Equivalent to java.uti 
l.Calendar.TUESDAY. 

114 */ 

115 public static final int TUESDAY = Calendar.TUESDAY; 
116 

117 73x 

118 * Useful constant for Wednesday. Equivalent to 

119 * java.util.Calendar.WEDNESDAY. 

120 Ty 

121 public static final int WEDNESDAY - Calendar.WEDNESDAY 
/ 

122 

123 ES 

124 * Useful constant for Thrusday. Equivalent to java.ut 
il.Calendar . THURSDAY. 

125 TL 


126 public static final int THURSDAY - Calendar.THURSDAY; 


127 











128 /** Useful constant for Friday. Equivalent to java.uti 
l.Calendar.FRIDAY. */ 

129 public static final int FRIDAY - Calendar.FRIDAY; 

130 

131 [ER 

132 * Useful constant for Saturday. Equivalent to java.ut 
il.Calendar . SATURDAY. 

133 */ 

134 public static final int SATURDAY = Calendar .SATURDAY; 
135 

136 /** Useful constant for Sunday. Equivalent to java.uti 
l.Calendar.SUNDAY. */ 

137 public static final int SUNDAY = Calendar .SUNDAY; 

138 

139 /** The number of days in each month in non leap years 
ee 

140 static final int[] LAST DAY OF MONTH = 

141 (0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 
}; 

142 

143 /** The number of days in a (non-leap) year up to the 
end of each month. */ 

144 static final int[] AGGREGATE DAYS TO END OF MONTH - 
145 (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 
334, 365}; 

146 

147 /** The number of days in a year up to the end of the 
preceding month. */ 

148 static final int[] AGGREGATE DAYS TO END OF PRECEDING 
MONTH - 

149 (0, ©, 31, 59, 90, 120, 151, 181, 212, 243, 273, 3 
04, 334, 365); 

150 

151 /** The number of days in a leap year up to the end of 
each month. */ 

152 static final int[] LEAP YEAR AGGREGATE DAYS TO END OF 
MONTH - 

153 (0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 
335, 366); 

154 

155 JER 

156 * The number of days in a leap year up to the end of 


the preceding month. 
157 */ 


158 static final int[] 





159 LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH 
160 (0, O, 31, 60, 91, 121, 152, 182, 213, 244, 27 
4, 305, 335, 366); 

161 

162 /** A useful constant for referring to the first week 
in a month. */ 

163 public static final int FIRST WEEK IN MONTH - 1; 

164 

165 /** A useful constant for referring to the second week 
in a month. */ 

166 public static final int SECOND WEEK IN MONTH - 2; 

167 

168 /** A useful constant for referring to the third week 
in a month. */ 

169 public static final int THIRD WEEK IN MONTH - 3; 

170 

171 /** A useful constant for referring to the fourth week 
in a month. */ 

172 public static final int FOURTH WEEK IN MONTH - 4; 

173 

174 /** A useful constant for referring to the last week i 
n a month. */ 

175 public static final int LAST WEEK IN MONTH - 0; 

176 

177 /** Useful range constant. */ 

178 public static final int INCLUDE NONE - 90; 

179 

180 /** Useful range constant. */ 

181 public static final int INCLUDE FIRST - 1; 

182 

183 /** Useful range constant. */ 

184 public static final int INCLUDE SECOND - 2; 

185 

186 /** Useful range constant. */ 

187 public static final int INCLUDE BOTH - 3; 

188 

189 y 

190 * Useful constant for specifying a day of the week re 
lative to a fixed 

191 * date. 

192 */ 

193 public static final int PRECEDING = -1; 


194 


195 
196 


Ped 
* Useful constant for specifying a day of the week re 


lative to a fixed 


197 
198 
199 
200 
201 
202 


* date. 
ny 
public static final int NEAREST - 0; 


Pu 
* Useful constant for specifying a day of the week re 


lative to a fixed 


203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 


* date. 
*/ 
public static final int FOLLOWING 


lI 
Hm 


/** A description for the date. */ 
private String description; 


/** 
* Default constructor. 
EPA 
protected SerialDate() { 
} 
JER 


* Returns <code>true</code> if the supplied integer c 


ode represents a 


218 


wise. 


219 
220 
221 
222 


* valid day-of-the-week, and <code>false</code> other 


Qparam code the code being checked for validity. 


+ + oo o 


@return <code>true</code> if the supplied integer c 


ode represents a 


223 


i valid day-of-the-week, and <code>false</cod 


e> otherwise. 


224 
225 
e) i 
226 
227 
228 
229 
230 
231 
232 


RY: 
public static boolean isValidweekdayCode(final int cod 


Switch(code) { 
case SUNDAY: 
case MONDAY: 
case TUESDAY: 
case WEDNESDAY: 
case THURSDAY: 


233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 


246 
247 


table, 


248 
249 
250 
251 
252 
253 
254 


case FRIDAY: 
case SATURDAY: 
return true; 
default: 
return false; 


/** 
* Converts the supplied string to a day of the week. 


* 


* param s a string representing the day of the week 


* 


* @return <code>-1</code> if the string is not conver 
the day of 
i the week otherwise. 
*/ 
public static int stringToWeekdayCode(String s) ( 


final String[] shortweekdayNames 
= DATE FORMAT SYMBOLS.getShortWeekdays( ); 
final String[] weekDayNames - DATE FORMAT SYMBOLS. 


getWeekdays(); 


255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 


int result = -1; 
S = s.trim(); 
for (int i = 0; i < weekDayNames.length; i++) { 
if (s.equals(shortweekdayNames[i])) { 
result - i; 
break; 
} 
if (s.equals(weekDayNames[i])) { 
result - i; 
break; 
} 
} 


return result; 


i 


/** 
* Returns a string representing the supplied day-of-t 


he-week. 


274 
275 
276 
271 
278 
279 
he-week. 
280 
281 
kday) { 
282 
283 


«p» 
Need to find a better approach. 


@param weekday the day of the week. 


+ FF ok 0k oko F 


Qreturn a string representing the supplied day-of-t 


*/ 
public static String weekdayCodeToString(final int wee 


final String[] weekdays = DATE FORMAT SYMBOLS.getW 


eekdays(); 


284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 


return weekdays[weekday ]; 


j 


f 22 
* Returns an array of month names. 


* 


* @return an array of month names. 
a 
public static String[] getMonths() { 


return getMonths(false); 


i 


/** 
* Returns an array of month names. 


* 


* @param shortened a flag indicating that shortened 


month names should 


303 
304 
305 
306 
307 
ed) 1 
308 
309 
310 
311 
312 
313 


? be returned. 
* 
* @return an array of month names. 
“ed 
public static String[] getMonths(final boolean shorten 


if (shortened) { 

return DATE FORMAT SYMBOLS.getShortMonths(); 
} 
else ( 

return DATE FORMAT SYMBOLS.getMonths(); 


314 
315 
316 
317 
318 
319 


j 


/** 
* Returns t 


S a valid month. 


320 
321 
322 
323 


* 


* 
* 
* 


ode represents a 
3 valid month. 


324 
325 
326 
{ 

327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 


*/ 


Qparam code 


rue if the supplied integer code represent 


the code being checked for validity. 


Qreturn <code>true</code> if the supplied integer c 


public static boolean isValidMonthCode(final int code) 


switch(code) ( 


case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


JANUARY : 
FEBRUARY : 
MARCH: 
APRIL: 
MAY: 

JUNE: 
JULY: 
AUGUST: 
SEPTEMBER: 
OCTOBER: 
NOVEMBER: 
DECEMBER: 
return true; 


default: 


N Ww 


return false; 


Returns the quarter for the specified month. 


* 
* 
* 
* @param code 
* 
* 
* 


the month code (1-12). 


@return the quarter that the month belongs to. 
Qthrows java.lang.IllegalArgumentException 


356 public static int monthCodeToQuarter(final int code) ( 
357 

358 switch(code) ( 

359 case JANUARY: 

360 case FEBRUARY: 

361 case MARCH: return 1; 

362 case APRIL: 

363 case MAY: 

364 case JUNE: return 2; 

365 case JULY: 

366 case AUGUST: 

367 case SEPTEMBER: return 3; 

368 case OCTOBER: 

369 case NOVEMBER: 

370 case DECEMBER: return 4; 

371 default: throw new IllegalArgumentException( 
272 "SerialDate.monthCodeToQuarter: invalid mo 
nth code."); 

373 } 

374 

375 } 

376 

377 pre 

378 * Returns a string representing the supplied month. 
379 * <P> 

380 * The string returned is the long form of the month n 
ame taken from the 

381 * default locale. 

382 * 

383 * param month the month. 

384 i 

335 * @return a string representing the supplied month. 
386 a7 

387 public static String monthCodeToString(final int month 
) i 

388 

389 return monthCodeToString(month, false); 

390 

391 } 

392 

393 peo 

394 * Returns a string representing the supplied month. 
395 * <P> 

396 * The string returned is the long or short form of th 


e month name taken 


397 
398 
399 
400 


from the default locale. 


Qparam month the month. 


* 
* 
* 
* 


bbreviation of the 


401 
402 
403 
404 
405 
406 


, 


407 


* month. 


* 


@param shortened if <code>true</code> return the a 


* @return a string representing the supplied month. 


* @throws java.lang.IllegalArgumentException 


a7: 


public static String monthCodeToString(final int month 


final boolean s 


hortened) { 


408 
409 
410 
411 
412 


// check arguments... 
if (!isValidMonthCode(month)) { 


throw new IllegalArgumentException( 


"SerialDate.monthCodeToString: month outsi 


de valid range."); 


413 } 

414 

415 final String[] months; 

416 

417 if (shortened) ( 

418 months = DATE FORMAT SYMBOLS.getShortMonths(); 
419 } 

420 else { 

421 months = DATE_FORMAT_SYMBOLS.getMonths(); 

422 } 

423 

424 return months[month - 1]; 

425 

426 } 

427 

428 pre 

429 * Converts a string to a month code. 

430 的 

<P> 

431 * This method will return one of the constants JANUAR 
Y, FEBRUARY, ..., 

432 * DECEMBER that corresponds to the string. If the st 


ring is not 


433 * recognised, this method returns -1. 

434 - 

435 * param s the string to parse. 

436 i 

437 * @return <code>-1</code> if the string is not parsea 
ble, the month of the 

438 3 year otherwise. 

439 Wh 

440 public static int stringToMonthCode(String s) { 

441 

442 final String[] shortMonthNames = DATE FORMAT SYMBO 
LS.getShortMonths(); 

443 final String[] monthNames - DATE FORMAT SYMBOLS.ge 
tMonths(); 

444 

445 int result = -1; 

446 s = s.trim(); 

447 

448 // first try parsing the string as an integer (1-1 
2)sss 

449 try ( 

450 result - Integer.parseInt(s); 

451 } 

452 catch (NumberFormatException e) { 

453 // suppress 

454 } 

455 

456 // now search through the month names... 

457 if ((result < 1) || (result > 12)) { 

458 for (int i = 0; i < monthNames.length; i++) { 
459 if (s.equals(shortMonthNames[i])) { 

460 result = i+ 1; 

461 break; 

462 } 

463 if (s.equals(monthNames[i])) { 

464 result = i+ 1; 

465 break; 

466 } 

467 } 

468 } 

469 

470 return result; 

471 

472 } 

473 


474 /** 


475 * Returns true if the supplied integer code represent 
S a valid 

476 * week-in-the-month, and false otherwise. 

477 ? 

478 * @param code the code being checked for validity. 
479 * @return <code>true</code> if the supplied integer c 


ode represents a 


480 E valid week-in-the-month. 

481 37 

482 public static boolean isValidweekInMonthCode(final int 
code) { 

483 

484 switch(code) ( 

485 case FIRST WEEK IN MONTH: 

486 case SECOND WEEK IN MONTH: 

487 case THIRD WEEK IN MONTH: 

488 case FOURTH WEEK IN MONTH: 

489 case LAST WEEK IN MONTH: return true; 

490 default: return false; 

491 ) 

492 

493 } 

494 

495 [ER 

496 * Determines whether or not the specified year is a 1 
eap year. 

497 $ 

498 * param yyyy the year (in the range 1900 to 9999). 
499 i 

500 * @return <code>true</code> if the specified year is 
a leap year. 

501 */ 

502 public static boolean isLeapYear(final int yyyy) { 
503 

504 if ((yyyy % 4) !- 0) ( 

505 return false; 

506 } 

507 else if ((yyyy % 400) == 0) { 

508 return true; 

509 } 

510 else if ((yyyy % 100) == 0) { 

511 return false; 

512 } 


513 else { 


514 
515 
516 
517 
518 
519 
520 


pecified year 


521 
522 
523 
524 
525 
526 
527 


} 


JEX 


return true; 


* Returns the number of leap years from 1900 to the s 


* INCLUSIVE. 
* <P> 


Note that 1900 is not a leap year. 
Qparam yyyy the year (in the range 1900 to 9999). 


Qreturn the number of leap years from 1900 to the s 


pecified year. 


528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
king 
540 
541 
542 
543 
544 
545 
546 
547 


l int yyyy) { 


548 
549 
550 
551 
552 
553 
554 


*/ 


public static int leapYearCount(final int yyyy) { 


j 


/** 


final int leap4 - (yyyy - 1896) / 4; 
final int leapi100 = (yyyy - 1800) / 100; 
final int leap400 - (yyyy - 1600) / 400; 
return leap4 - leapi100 + leap400; 


* Returns the number of the last day of the month, ta 
into account 
* leap years. 


* 


* 
* 
* 
* 


AT: 


@param month the month. 
@param yyyy the year (in the range 1900 to 9999). 


@return the number of the last day of the month. 


public static int lastDayOfMonth(final int month, fina 


final int result - LAST DAY OF MONTH[month]; 
if (month != FEBRUARY) { 
return result; 


else if (isLeapYear(yyyy)) { 
return result + 1; 


555 


556 else ( 

557 return result; 

558 ) 

559 

560 } 

561 

562 ys 

563 * Creates a new date by adding the specified number o 
f days to the base 

564 * date. 

565 x 

566 * @param days the number of days to add (can be nega 
tive). 

567 * (param base the base date. 

568 $ 

569 * @return a new date. 

570 */ 

571 public static SerialDate addDays(final int days, final 
SerialDate base) { 

572 

573 final int serialDayNumber = base.toSerial() + days 
T 

574 return SerialDate.createlInstance(serialDayNumber); 
575 

576 } 

577 

578 JER 

579 * Creates a new date by adding the specified number o 
f months to the base 

580 * date. 

581 * <P> 

582 * If the base date is close to the end of the month, 
the day on the result 

583 * may be adjusted slightly: 31 May + 1 month = 30 Ju 
ne. 

584 i 

585 * @param months the number of months to add (can be 
negative). 

586 * param base the base date. 

587 T 

588 * @return a new date. 

589 */ 

590 public static SerialDate addMonths(final int months, 


591 final SerialDate ba 


se) { 


592 

593 final int yy = (12 * base.getYYYY() + base.getMont 
h() * months - 1) 

594 / 12; 

595 final int mm = (12 * base.getYYYY() + base.getMont 
h() + months - 1) 

596 % 12 + 1; 

597 final int dd = Math.min( 

598 base.getDayOfMonth(), SerialDate.lastDayOfMont 
h(mm, yy) 

599 : 

600 return SerialDate.createlnstance(dd, mm, yy); 

601 

602 ) 

603 

604 pe 

605 * Creates a new date by adding the specified number o 
f years to the base 

606 * date. 

607 

608 * @param years the number of years to add (can be ne 
gative). 

609 * param base the base date. 

610 f 

611 * @return A new date. 

612 T 

613 public static SerialDate addYears(final int years, fin 
al SerialDate base) ( 

614 

615 final int baseY - base.getYYYY(); 

616 final int baseM = base.getMonth(); 

617 final int baseD = base.getDayOfMonth(); 

618 

619 final int targetY = baseY + years; 

620 final int targetD = Math.min( 

621 baseD, SerialDate.lastDayOfMonth(baseM, target 
Y) 

622 ); 

623 

624 return SerialDate.createInstance(targetD, baseM, t 
argetY); 

625 

626 } 


627 


628 
629 


630 

631 

632 
the-week. 

633 

634 

635 


/** 


* Returns the latest date that falls on the specified 
day-of-the-week and 


* 


* 


* 


* 


* 


is BEFORE the base date. 
Qparam targetWeekday a code for the target day-of- 
@param base the base date. 


Qreturn the latest date that falls on the specified 


day-of-the-week and 


636 
637 
638 


639 


* 


*/ 


is BEFORE the base date. 


public static SerialDate getPreviousDayOfWeek(final in 
t targetWeekday, 


final Se 


rialDate base) ( 


640 
641 
642 
{ 
643 
644 
645 
646 
647 
648 
649 
650 
651 
652 
653 
654 
655 
DOW); 


656 
657 
658 
659 
660 
661 
662 


j 
JEER 


// check arguments... 
if (!SerialDate.isValidWeekdayCode(targetWeekday)) 


throw new IllegalArgumentException( 
"Invalid day-of-the-week code." 
); 
} 


// find the date... 
final int adjust; 
final int baseDOW = base.getDayOfWeek(); 
if (baseDOW > targetWeekday) { 
adjust = Math.min(0, targetWeekday - baseDOW); 


} 
else ( 

adjust = -7 + Math.max(0, targetWeekday - base 
} 


return SerialDate.addDays(adjust, base); 


663 * Returns the earliest date that falls on the specifi 
ed day-of-the-week 


664 * and is AFTER the base date. 

665 is 

666 * @param targetWeekday a code for the target day-of- 
the-week. 

667 * @param base the base date. 

668 * 

669 * Qreturn the earliest date that falls on the specifi 
ed day-of-the-week 

670 $ and is AFTER the base date. 

671 */ 

672 public static SerialDate getFollowingDayOfWeek(final i 
nt targetWeekday, 

673 final S 
erialDate base) ( 

674 

675 // check arguments... 

676 if (!SerialDate.isValidweekdayCode(targetWeekday ) ) 
{ 

677 throw new IllegalArgumentException( 

678 "Invalid day-of-the-week code." 

679 ); 

680 } 

681 

682 // find the date... 

683 final int adjust; 

684 final int baseDOW = base.getDayOfWeek(); 

685 if (baseDOW > targetWeekday) { 

686 adjust = 7 + Math.min(0, targetWeekday - baseD 
OW) ; 

687 } 

688 else { 

689 adjust = Math.max(0, targetWeekday - baseDOW); 
690 } 

691 

692 return SerialDate.addDays(adjust, base); 

693 } 

694 

695 les 

696 * Returns the date that falls on the specified day-of 
-the-week and is 

697 * CLOSEST to the base date. 

698 i‘ 


699 * @param targetDOW a code for the target day-of-the- 


week. 


700 * (param base the base date. 

701 $ 

702 * @return the date that falls on the specified day-of 
-the-week and is 

703 i CLOSEST to the base date. 

704 i3 d 

705 public static SerialDate getNearestDayOfWeek(final int 
targetDOW, 

706 final Ser 
ialDate base) ( 

707 

708 // check arguments... 

709 if (!SerialDate.isValidweekdayCode(targetDOW)) { 
710 throw new IllegalArgumentException( 

711 "Invalid day-of-the-week code." 

712 ); 

713 } 

714 

715 // find the date... 

716 final int baseDOW = base.getDayOfWeek(); 

717 int adjust = -Math.abs(targetDOW - baseDOW); 

718 if (adjust >= 4) { 

719 adjust = 7 - adjust; 

720 } 

721 if (adjust <= -4) { 

722 adjust = 7 + adjust; 

723 } 

724 return SerialDate.addDays(adjust, base); 

725 

726 } 

727 

728 J 

729 * Rolls the date forward to the last day of the month 
730 li 

731 * param base the base date. 

732 $ 

733 * return a new serial date. 

734 */ 

735 public SerialDate getEndOfCurrentMonth(final SerialDat 
e base) { 

736 final int last = SerialDate.lastDayOfMonth( 

737 base.getMonth(), base.getYYYY() 


738 ); 


739 return SerialDate.createInstance(last, base.getMon 
th(), base.getYYYY()); 

740 

741 

742 risa 

743 * Returns a string corresponding to the week-in-the-m 
onth code. 
744 

745 

746 

747 @param count an integer code representing the week 
-in-the-month. 

748 = 

749 * @return a string corresponding to the week-in-the-m 
onth code. 

750 "y 

751 public static String weekInMonthToString(final int cou 
nt) { 

752 

753 switch (count) { 

754 case SerialDate.FIRST_WEEK_IN_MONTH : return " 
First"; 

755 case SerialDate.SECOND_WEEK_IN_MONTH : return 
"Second"; 

756 case SerialDate.THIRD_WEEK_IN_MONTH : return " 
Third"; 

757 case SerialDate.FOURTH_WEEK_IN_MONTH : return 
"Fourth"; 

758 case SerialDate.LAST_WEEK_IN_MONTH : return "L 
ast"; 

759 default 

760 return "SerialDate.weekInMonthToString(): 
invalid code."; 

761 } 

762 

763 } 

764 

765 JE 

766 * Returns a string representing the supplied 'relativ 


<P> 
Need to find a better approach. 


+ + oo 


es 
767 
768 
769 
770 
ive' 


<P> 
Need to find a better approach. 


+ + + o 


@param relative a constant representing the 'relat 


771 5 


772 * @return a string representing the supplied 'relativ 
e'. 

773 Tg 

774 public static String relativeToString(final int relati 
ve) { 

775 

776 switch (relative) { 

777 case SerialDate.PRECEDING : return "Preceding" 
了 

778 case SerialDate.NEAREST : return "Nearest"; 
779 case SerialDate.FOLLOWING : return "Following" 
了 

780 default : return "ERROR : Relative To String"; 
781 } 

782 

783 } 

784 

785 fest 

786 * Factory method that returns an instance of some con 
crete subclass of 

787 * {@link SerialDate}. 

788 is 

789 * @param day the day (1-31). 

790 * @param month the month (1-12). 

791 * @param yyyy the year (in the range 1900 to 9999). 
792 t 

793 * @return An instance of {@link SerialDate}. 

794 ag 

795 public static SerialDate createInstance(final int day, 
final int month, 

796 final int yyyy 
) i 

797 return new SpreadsheetDate(day, month, yyyy); 

798 } 

799 

800 pre 

801 * Factory method that returns an instance of some con 
crete subclass of 

802 * {@link SerialDate}. 

803 ig 

804 * @param serial the serial number for the day (1 Jan 
uary 1900 = 2). 

805 i 

806 * @return a instance of SerialDate. 


807 */ 


808 public static SerialDate createInstance(final int seri 
al) { 

809 return new SpreadsheetDate(serial); 

810 } 

811 

812 fe 

813 * Factory method that returns an instance of a subcla 
ss of SerialDate. 

814 $ 

815 * @param date A Java date object. 

816 $ 

817 * @return a instance of SerialDate. 

818 */ 

819 public static SerialDate createlnstance(final java.uti 
l.Date date) ( 

820 

821 final GregorianCalendar calendar - new GregorianCa 
lendar(); 

822 calendar.setTime(date); 

823 return new SpreadsheetDate(calendar.get(Calendar.D 
ATE), 

824 calendar.get(Calendar.M 
ONTH) + 1, 

825 calendar.get(Calendar.Y 
EAR)); 

826 

827 } 

828 

829 pre 

830 * Returns the serial number for the date, where 1 Jan 
uary 1900 = 2 (this 

831 * corresponds, almost, to the numbering system used i 
n Microsoft Excel for 

832 * Windows and Lotus 1-2-3). 

833 A 

834 * @return the serial number for the date. 

835 */ 

836 public abstract int toSerial(); 

837 

838 AS 

839 * Returns a java.util.Date. Since java.util.Date has 

more precision than 

840 * SerialDate, we need to define a convention for the 


'time of day'. 


841 


* 


842 * @return this as <code>java.util.Date</code>. 
843 */ 

844 public abstract java.util.Date toDate(); 

845 

846 [ER 

847 * Returns a description of the date. 

848 c 

849 * @return a description of the date. 

850 */ 

851 public String getDescription() { 

852 return this.description; 

853 ) 

854 

855 "iba 

856 * Sets the description for the date. 

857 » 

858 * (param description the new description for the dat 
e. 

859 T 

860 public void setDescription(final String description) { 
861 this.description - description; 

862 } 

863 

864 | 

865 * Converts the date to a string. 

866 : 

867 * @return a string representation of the date. 
868 af 

869 public String toString() { 

870 return getDayOfMonth() + "-" + SerialDate.monthCod 
eToString(getMonth() ) 

871 + "-" + getYYYY(); 
872 } 

873 

874 pre 

875 * Returns the year (as 

sume a valid range of 1900 to 9999). 

876 * 

877 * @return the year. 

878 ny 

879 public abstract int getYYYY(); 


880 


881 ^t 


882 * Returns the month (January - 1, February - 2, March 
- 3). 
883 k 
884 * @return the month of the year. 
885 */ 
886 public abstract int getMonth(); 
887 
888 [55 
889 * Returns the day of the month. 
890 d 
891 * @return the day of the month. 
892 Tf 
893 public abstract int getDayOfMonth(); 
894 
895 LES 
896 * Returns the day of the week. 
897 d 
898 * Qreturn the day of the week. 
899 ef 
900 public abstract int getDayOfWeek(); 
901 
902 Jh 
903 * Returns the difference (in days) between this date 
and the specified 
904 * 'other' date. 
905 * «p» 
906 * The result is positive if this date is after the 'o 
ther' date and 
907 * negative if it is before the 'other' date. 
908 a 
909 * (param other the date being compared to. 
910 * 
911 * @return the difference between this and the other d 
ate. 
912 ny 
913 public abstract int compare(SerialDate other); 
914 
915 y 
916 * Returns true if this SerialDate represents the same 
date as the 
917 * specified SerialDate. 
918 T 
919 * (param other the date being compared to. 
* 


920 


921 * @return <code>true</code> if this SerialDate repres 
ents the same date as 


922 ii the specified SerialDate. 

923 */ 

924 public abstract boolean isOn(SerialDate other); 

925 

926 4S 

927 * Returns true if this SerialDate represents an earli 
er date compared to 

928 * the specified SerialDate. 

929 i 

930 * (param other The date being compared to. 

931 3 

932 * @return <code>true</code> if this SerialDate repres 


ents an earlier date 


933 b compared to the specified SerialDate. 
934 Tf 

935 public abstract boolean isBefore(SerialDate other); 
936 

937 /** 

938 * Returns true if this SerialDate represents the same 
date as the 

939 * specified SerialDate. 

940 i 

941 * (param other the date being compared to. 

942 ¥ 

943 * @return <code>true<code> if this SerialDate represe 
nts the same date 

944 * as the specified SerialDate. 

945 */ 

946 public abstract boolean isOnOrBefore(SerialDate other) 
/ 

947 

948 XT 

949 * Returns true if this SerialDate represents the same 
date as the 

950 * specified SerialDate. 

951 * 

952 * (param other the date being compared to. 

953 3 

954 * @return <code>true</code> if this SerialDate repres 
ents the same date 

955 j as the specified SerialDate. 

956 */ 


957 public abstract boolean isAfter(SerialDate other); 


958 


959 yp 

960 * Returns true if this SerialDate represents the same 
date as the 

961 * specified SerialDate. 

962 - 

963 * (param other the date being compared to. 

964 T 

965 * return <code>true</code> if this SerialDate repres 
ents the same date 

966 Ü as the specified SerialDate. 

967 TE 

968 public abstract boolean isOnOrAfter(SerialDate other); 
969 

970 £t 

971 * Returns <code>true</code> if this {@link SerialDate 
) is within the 

972 * specified range (INCLUSIVE). The date order of d1 
and d2 is not 

973 * important. 

974 * 

975 * (param di a boundary date for the range. 

976 * (param d2 the other boundary date for the range. 
977 * 

978 * @return A boolean. 

979 TE 

980 public abstract boolean isInRange(SerialDate di, Seria 
lDate d2); 

981 

982 pe 

983 * Returns <code>true</code> if this {@link SerialDate 
} is within the 

984 * specified range (caller specifies whether or not th 
e end-points are 

985 * included). The date order of d1 and d2 is not impo 
rtant. 

986 i 

987 * @param di a boundary date for the range. 

988 * param d2 the other boundary date for the range. 
989 * param include a code that controls whether or not 
the start and end 

990 $ dates are included in the range. 
991 $ 

992 * @return A boolean. 


993 */ 


994 public abstract boolean isInRange(SerialDate di, Seria 


lDate d2, 
995 int include); 
996 
997 pre 
998 * Returns the latest date that falls on the specified 
day-of-the-week and 
999 * is BEFORE this date. 
1000 = 
1001 * @param targetDOW a code for the target day-of-the- 
week. 
1002 2 
1003 * @return the latest date that falls on the specified 
day-of-the-week and 
1004 3 is BEFORE this date. 
1005 */ 
1006 public SerialDate getPreviousDayOfWeek(final int targe 
tDOW) ( 
1007 return getPreviousDayOfWeek(targetDOW, this); 
1008 ) 
1009 
1010 A 
1011 * Returns the earliest date that falls on the specifi 
ed day-of-the-week 
1012 * and is AFTER this date. 
1013 也 
1014 * @param targetDOW a code for the target day-of-the- 
week. 
1015 3 
1016 * @return the earliest date that falls on the specifi 
ed day-of-the-week 
1017 ^ and is AFTER this date. 
1018 */ 
1019 public SerialDate getFollowingDayOfWeek(final int targ 
etDOW) { 
1020 return getFollowingDayOfWeek(targetDOW, this); 
1021 } 
1022 
1023 人 
1024 * Returns the nearest date that falls on the specifie 
d day-of-the-week. 
1025 5 
1026 * @param targetDOW a code for the target day-of-the- 
week. 


1027 1 


1028 


return the nearest date that falls on the specifie 
* Qret th t date that fall th ifi 


d day-of-the-week. 


1029 
1030 
DOW) 
1031 
1032 
1033 
1034 


{ 


j 


*/ 
public SerialDate getNearestDayOfWeek(final int target 


return getNearestDayOfWeek(targetDOW, this); 
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(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


Project Info: http://www.jfree.org/jcommon/index.html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries. ] 


(C) Copyright 2001-2005, by Object Refinery Limited. 


Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): -; 


35 * $Id: SerialDateTests.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 
36 * 

37 * Changes 

38 * ------- 

39 * 15-Nov-2001 : Version 1 (DG); 

40 * 25-Jun-2002 : Removed unnecessary import (DG); 

41 * 24-Oct-2002 : Fixed errors reported by Checkstyle (DG); 
42 * 13-Mar-2003 : Added serialization test (DG); 

43 * 05-Jan-2005 : Added test for bug report 1096282 (DG); 
44 * 

4b */ 

46 

47 package org.jfree.date.junit; 

48 


49 import java.io.ByteArrayInputStream; 
50 import java.io.ByteArrayOutputStream; 
51 import java.io.ObjectInput; 

52 import java.io.ObjectInputStream; 

53 import java.io.ObjectOutput; 

54 import java.io.ObjectOutputStream; 

55 

56 import junit.framework.Test; 

57 import junit.framework.TestCase; 

58 import junit.framework.TestSuite; 

59 

60 import org.jfree.date.MonthConstants; 
61 import org.jfree.date.SerialDate; 


62 

63 /** 

64 * Some JUnit tests for the (Qlink SerialDate) class. 
65 */ 

66 public class SerialDateTests extends TestCase { 

67 

68 /** pate representing November 9. */ 

69 private SerialDate nov9Y2001; 

70 

71 pre 

72 * Creates a new test case. 

73 i 

74 * (param name the name. 

75 xA 

76 public SerialDateTests(final String name) { 

77 super (name); 

78 } 

79 

80 [re 

81 * Returns a test suite for the JUnit test runner. 
82 * 

83 * @return The test suite. 

84 tA 

85 public static Test suite() ( 

86 return new TestSuite(SerialDateTests.class); 
87 } 

88 

89 y udo 

90 * Problem set up. 

91 y 

92 protected void setUp() { 

93 this.nov9Y2001 - SerialDate.createInstance(9, MonthConstants.NOVEMBER, 
2001); 


94 } 


95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 


VALE 
* 9 Nov 2001 plus two months should be 9 Jan 2002. 
*/ 
public void testAddMonthsTo9Nov2001() { 
final SerialDate jan9Y2002 - SerialDate.addMonths(2, this.nov9Y2001); 
final SerialDate answer - SerialDate.createInstance(9, 1, 2002); 
assertEquals(answer, jan9Y2002); 


j 


/** 
* A test case for a reported bug, now fixed. 
*/ 
public void testAddMonthsTo50ct2003() { 
final SerialDate d1 = SerialDate.createInstance(5, MonthConstants.OCT 


OBER, 2003) ; 


110 
111 


, 2003)); 


112 
113 
114 
115 
116 
117 
118 


final SerialDate d2 - SerialDate.addMonths(2, d1); 
assertEquals(d2, SerialDate.createInstance(5, MonthConstants.DECEMBER 


/** 
* A test case for a reported bug, now fixed. 
xf 
public void testAddMonthsTo1Jan2003() { 
final SerialDate d1 = SerialDate.createInstance(1, MonthConstants.JA 


NUARY, 2003); 


119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 


final SerialDate d2 = SerialDate.addMonths(0, d1); 
assertEquals(d2, d1); 


j 


JEF 
* Monday preceding Friday 9 November 2001 should be 5 November. 
*/ 
public void testMondayPrecedingFriday9Nov2001() ( 
SerialDate mondayBefore - SerialDate.getPreviousDayOfWeek( 
SerialDate.MONDAY, this.nov9Y2001 
); 
assertEquals(5, mondayBefore.getDayOfMonth()); 
} 


ER 
* Monday following Friday 9 November 2001 should be 12 November. 
*/ 
public void testMondayFollowingFriday9Nov2001() { 
SerialDate mondayAfter = SerialDate.getFollowingDayOfWeek( 
SerialDate.MONDAY, this.nov9Y2001 
); 
assertEquals(12, mondayAfter.getDayOfMonth()); 
} 


JEX 
* Monday nearest Friday 9 November 2001 should be 12 November. 
*/ 
public void testMondayNearestFriday9Nov2001() { 
SerialDate mondayNearest - SerialDate.getNearestDayOfWeek( 
SerialDate.MONDAY, this.nov9Y2001 
); 
assertEquals(12, mondayNearest.getDayOfMonth()); 


Pek 
* The Monday nearest to 22nd January 1970 falls on the 19th. 
*/ 
public void testMondayNearest22Jan1970() { 
SerialDate jan22Y1970 = SerialDate.createInstance 
(22, MonthConstants. JANUARY, 1970); 
SerialDate mondayNearest-SerialDate.getNearestDayOfWeek 
(SerialDate.MONDAY, jan22Y1970); 
assertEquals(19, mondayNearest.getDayOfMonth()); 


j 


/** 
* Problem that the conversion of days to strings returns the right result 


* Actually, this 
* result depends on the Locale so this test needs to be modified. 
*/ 

public void testWeekdayCodeToString() { 


final String test - SerialDate.weekdayCodeToString(SerialDate.SATURDA 


assertEquals("Saturday", test); 


j 


/** 
* Test the conversion of a string to a weekday. Note that this test will 


fail if the 
* default locale doesn't use English weekday names...devise a better test 


*/ 
public void testStringToWeekday() { 


int weekday = SerialDate.stringToWeekdayCode( Wednesday"); 
assertEquals(SerialDate.WEDNESDAY, weekday); 


weekday - SerialDate.stringToWeekdayCode(" Wednesday "); 
assertEquals(SerialDate.WEDNESDAY, weekday); 


weekday = SerialDate.stringToWeekdayCode( "Wed"); 
assertEquals(SerialDate.WEDNESDAY, weekday); 


j 


/** 
* Test the conversion of a string to a month. Note that this test will 
fail if the 
* default locale doesn't use English month names...devise a better test! 
*/ 
public void testStringToMonthCode() { 


int m - SerialDate.stringToMonthCode("January"); 
assertEquals(MonthConstants.JANUARY, m); 


m = SerialDate.stringToMonthCode(" January "); 
assertEquals(MonthConstants.JANUARY, m); 


m = SerialDate.stringToMonthCode("Jan"); 
assertEquals(MonthConstants.JANUARY, m); 


205 ) 


206 

207 pre 

208 * Tests the conversion of a month code to a string. 

209 */ 

210 public void testMonthCodeToStringCode() { 

211 

212 final String test = SerialDate.monthCodeToString(MonthConstants.DECEM 
BER); 

213 assertEquals("December", test); 

214 

215 } 

216 

217 JUR 

218 * 1900 is not a leap year. 

219 S 

220 public void testIsNotLeapYear1900() { 

221 assertTrue(!SerialDate.isLeapYear(1900)); 

222 } 

223 

224 ER 

225 * 2000 is a leap year. 

226 ud 

227 public void testIsLeapYear2000() { 

228 assertTrue(SerialDate.isLeapYear(2000)); 

229 } 

230 

231 fee 

232 * The number of leap years from 1900 up-to-and-including 1899 is 0. 
233 "A 

234 public void testLeapYearCounti1899() { 

235 assertEquals(SerialDate.leapYearCount(1899), 0); 

236 } 

237 

238 Jew 

239 * The number of leap years from 1900 up-to-and-including 1903 is 0. 
240 */ 

241 public void testLeapYearCount1903() { 

242 assertEquals(SerialDate.leapYearCount(1903), 0); 

243 } 

244 

245 [rw 

246 * The number of leap years from 1900 up-to-and-including 1904 is 1. 
247 af 

248 public void testLeapYearCounti1904() { 

249 assertEquals(SerialDate.leapYearCount(1904), 1); 

250 } 

251 

252 LEF 

253 * The number of leap years from 1900 up-to-and-including 1999 is 24. 
254 uA 

255 public void testLeapYearCounti1999() { 

256 assertEquals(SerialDate.leapYearCount(1999), 24); 

257 } 

258 

259 Ped 

260 * The number of leap years from 1900 up-to-and-including 2000 is 25. 
261 xy 

262 public void testLeapYearCount2000() { 

263 assertEquals(SerialDate.leapYearCount(2000), 25); 


264 ) 


JEF 
* Serialize an instance, restore it, and check for equality. 
*/ 

public void testSerialization() { 


SerialDate d1 
SerialDate d2 


SerialDate.createInstance(15, 4, 2000); 
null; 


try { 
ByteArrayOutputStream buffer = new ByteArrayOutputStream(); 


ObjectOutput out - new ObjectOutputStream(buffer); 
out.writeObject(d1); 
out.close(); 


ObjectInput in = new ObjectInputStream 


(new ByteArrayInputStream(buffer.toByteArray 


d2 - (SerialDate) in.readObject(); 
in.close(); 

} 

catch (Exception e) { 
System.out.println(e.toString()); 

} 


assertEquals(d1, d2); 


j 


fer 
* A test for bug report 1096282 (now fixed). 
*/ 
public void test1096282() { 
SerialDate d = SerialDate.createInstance(29, 2, 2004); 
d = SerialDate.addYears(1, d); 
SerialDate expected = SerialDate.createInstance(28, 2, 2005); 
assertTrue(d.isOn(expected)); 


j 


JEE 
* Miscellaneous tests for the addMonths() method. 
*/ 
public void testAddMonths() { 
SerialDate di = SerialDate.createInstance(31, 5, 2004); 


SerialDate d2 = SerialDate.addMonths(1, d1); 
assertEquals(30, d2.getDayOfMonth()); 
assertEquals(6, d2.getMonth()); 
assertEquals(2004, d2.getYYYY()); 


SerialDate d3 = SerialDate.addMonths(2, d1); 
assertEquals(31, d3.getDayOfMonth()); 
assertEquals(7, d3.getMonth()); 
assertEquals(2004, d3.getYYYY()); 


SerialDate d4 = SerialDate.addMonths(1, SerialDate.addMonths(1, d1)); 


assertEquals(30, d4.getDayOfMonth()); 
assertEquals(7, d4.getMonth()); 
assertEquals(2004, d4.getYYYY()); 


lm 


代码 
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JCommon : a free general purpose class library for the Java(tm) platform 


(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


Project Info: http://ww.jfree.org/jcommon/index. html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries. ] 


(C) Copyright 2002, 2003, by Object Refinery Limited. 


Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): - 


$Id: MonthConstants.java,v 1.4 2005/11/16 15:58:40 taqua Exp $ 
Changes 


29-May-2002 : Version 1 (code moved from SerialDate class) (DG); 


package org.jfree.date; 


/* 


* 


+ 水 OF 


pu 


* 


Useful constants for months. Note that these are NOT equivalent to the 
constants defined by java.util.Calendar (where JANUARY=0 and DECEMBER=11). 
<P> 

Used by the SerialDate and RegularTimePeriod classes. 


@author David Gilbert 
/ 
blic interface MonthConstants { 


/** Constant for January. */ 
public static final int JANUARY = 1; 


/** Constant for February. */ 
public static final int FEBRUARY = 2; 


/** Constant for March. */ 











public static final int MARCH = 3; 
/** Constant for April. */ 
public static final int APRIL - 4; 


/** Constant for May. */ 
public static final int MAY - 5; 


/** Constant for June. */ 
public static final int JUNE - 6; 


72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
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/** Constant for July. */ 

public static final int JULY = 7; 

/** Constant for August. */ 

public static final int AUGUST = 8; 

/** Constant for September. */ 

public static final int SEPTEMBER = 9; 

/** Constant for October. */ 

public static final int OCTOBER = 10; 

/** Constant for November. */ 

public static final int NOVEMBER - 11; 

/** Constant for December. */ 

public static final int DECEMBER - 12; 
} 


package org.jfree.date. junit; 


import junit.framework.TestCase; 
import org.jfree.date.*; 
import static org.jfree.date.SerialDate.*; 


import java.util.*; 
public class BobsSerialDateTest extends TestCase { 


public void testIsValidweekdayCode() throws Exception { 
for (int day = 1; day <= 7; day++) 
assertTrue(isValidWeekdayCode(day)); 
assertFalse(isValidWeekdayCode(0)); 
assertFalse(isValidWeekdayCode(8)); 


} 
public void testStringToWeekdayCode() throws Exception { 


assertEquals(-1, stringToWeekdayCode("Hello")); 
assertEquals(MONDAY, stringToweekdayCode("Monday")); 
assertEquals(MONDAY, stringToWeekdayCode("Mon")); 

//todo assertEquals(MONDAY, stringToweekdayCode ( "monday" )); 

// assertEquals(MONDAY, stringToWeekdayCode ( " MONDAY")) ; 

// assertEquals(MONDAY, stringToWeekdayCode("mon")); 


assertEquals(TUESDAY, stringToWeekdayCode("Tuesday")); 
assertEquals(TUESDAY, stringToWeekdayCode("Tue")); 
// assertEquals( TUESDAY, stringToweekdayCode("tuesday")); 
// assertEquals (TUESDAY, stringToWeekdayCode ( " TUESDAY")) ; 
// assertEquals(TUESDAY, stringToWeekdayCode("tue")); 
// assertEquals(TUESDAY, stringToWeekdayCode("tues")); 


assertEquals(WEDNESDAY, stringToWeekdayCode( "Wednesday" )); 
assertEquals(WEDNESDAY, stringToWeekdayCode( "Wed")); 
// assertEquals(WEDNESDAY, stringToweekdayCode("wednesday") ); 
If assertEquals(WEDNESDAY, stringToweekdayCode("WEDNESDAY") ) ; 
TA assertEquals(WEDNESDAY, stringToWeekdayCode("wed")); 


assertEquals(THURSDAY, stringToWeekdayCode("Thursday")); 
assertEquals(THURSDAY, stringToWeekdayCode("Thu")); 
// assertEquals( THURSDAY, stringToWeekdayCode("thursday")); 
// assertEquals( THURSDAY, stringToweekdayCode("THURSDAY") ) ; 
f assertEquals(THURSDAY, stringToWeekdayCode("thu")); 
// assertEquals(THURSDAY, stringToWeekdayCode("thurs")); 


assertEquals(FRIDAY, stringToweekdayCode("Friday")); 
assertEquals(FRIDAY, stringToweekdayCode("Fri")); 
// assertEquals(FRIDAY, stringToweekdayCode("friday")); 
// assertEquals(FRIDAY, stringToweekdayCode("FRIDAY")); 
// assertEquals(FRIDAY, stringToWeekdayCode("fri")); 


assertEquals(SATURDAY, stringToWeekdayCode("Saturday")); 
assertEquals(SATURDAY, stringToWeekdayCode("Sat")); 


代码 清音 
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55 // assertEquals(SATURDAY, stringToWeekdayCode("saturday")); 
56 // assertEquals(SATURDAY, stringToWeekdayCode( " SATURDAY" )) ; 
57 // assertEquals(SATURDAY, stringToWeekdayCode("sat")); 

58 

59 assertEquals(SUNDAY, stringToWeekdayCode("Sunday")); 

60 assertEquals(SUNDAY, stringToWeekdayCode("Sun")); 

61 // assertEquals(SUNDAY, stringToWeekdayCode ( "sunday")); 

62 // assertEquals(SUNDAY, stringToWeekdayCode ( "SUNDAY")) ; 

63 // assertEquals(SUNDAY, stringToWeekdayCode("sun")); 


64 } 

65 

66 public void testWeekdayCodeToString() throws Exception { 
67 assertEquals("Sunday", weekdayCodeToString(SUNDAY)); 

68 assertEquals("Monday", weekdayCodeToString(MONDAY)); 

69 assertEquals("Tuesday", weekdayCodeToString(TUESDAY)); 
70 assertEquals("Wednesday", weekdayCodeToString(WEDNESDAY)); 
71 assertEquals("Thursday", weekdayCodeToString(THURSDAY)); 
72 assertEquals("Friday", weekdayCodeToString(FRIDAY)); 

73 assertEquals("Saturday", weekdayCodeToString(SATURDAY)); 
74 } 

75 

76 public void testIsValidMonthCode() throws Exception { 

77 for (int i = 1; i <= 12; i++) 

78 assertTrue(isValidMonthCode(i)); 

79 assertFalse(isValidMonthCode(0)); 

80 assertFalse(isValidMonthCode(13)); 

81 } 

82 

83 public void testMonthToQuarter() throws Exception { 

84 assertEquals(1, monthCodeToQuarter( JANUARY) ) ; 

85 assertEquals(1, monthCodeToQuarter(FEBRUARY)) ; 

86 assertEquals(1, monthCodeToQuarter(MARCH)); 

87 assertEquals(2, monthCodeToQuarter(APRIL)); 

88 assertEquals(2, monthCodeToQuarter(MAY)); 

89 assertEquals(2, monthCodeToQuarter(JUNE)); 

90 assertEquals(3, monthCodeToQuarter(JULY)); 

91 assertEquals(3, monthCodeToQuarter (AUGUST) ); 

92 assertEquals(3, monthCodeToQuarter (SEPTEMBER) ) ) ; 

93 assertEquals(4, monthCodeToQuarter (OCTOBER) ) ; 

94 assertEquals(4, monthCodeToQuarter (NOVEMBER) ); 

95 assertEquals(4, monthCodeToQuarter (DECEMBER) ); 

96 

97 try { 

98 monthCodeToQuarter(-1); 

99 fail("Invalid Month Code should throw exception"); 
100 } catch (IllegalArgumentException e) { 

101 } 

102 } 

103 

104 public void testMonthCodeToString() throws Exception { 
105 assertEquals("January", monthCodeToString( JANUARY ) ); 
106 assertEquals("February", monthCodeToString(FEBRUARY ) ); 
107 assertEquals("March", monthCodeToString(MARCH) ); 

108 assertEquals("April", monthCodeToString(APRIL) ); 

109 assertEquals("May", monthCodeToString(MAY)); 

110 assertEquals("June", monthCodeToString( JUNE) ); 

111 assertEquals("July", monthCodeToString(JULY) ); 

112 assertEquals("August", monthCodeToString(AUGUST)); 

113 assertEquals("September", monthCodeToString(SEPTEMBER)); 
114 assertEquals("October", monthCodeToString(OCTOBER)); 
115 assertEquals("November", monthCodeToString(NOVEMBER)); 
116 assertEquals("December", monthCodeToString(DECEMBER)); 
117 

118 assertEquals("Jan", monthCodeToString(JANUARY, true)); 
119 assertEquals("Feb", monthCodeToString(FEBRUARY, true)); 
120 assertEquals("Mar", monthCodeToString(MARCH, true)); 
121 assertEquals("Apr", monthCodeToString(APRIL, true)); 
122 assertEquals("May", monthCodeToString(MAY, true)); 

123 assertEquals("Jun", monthCodeToString(JUNE, true)); 

124 assertEquals("Jul", monthCodeToString(JULY, true)); 

125 assertEquals("Aug", monthCodeToString(AUGUST, true)); 
126 assertEquals("Sep", monthCodeToString(SEPTEMBER, true)); 
127 assertEquals("Oct", monthCodeToString(OCTOBER, true)); 
128 assertEquals("Nov", monthCodeToString(NOVEMBER, true)); 
129 assertEquals("Dec", monthCodeToString(DECEMBER, true)); 
130 

131 try { 

132 monthCodeToString(-1); 

133 fail("Invalid month code should throw exception"); 
134 } catch (IllegalArgumentException e) { 

135 } 

136 

137 } 

138 


139 public void testStringToMonthCode() throws Exception { 
140 assertEquals(JANUARY, stringToMonthCode("1")); 


141 
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165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
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211 
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213 
214 
215 
216 
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218 
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220 
221 
222 
223 
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226 


// 
// 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


assertEquals(FEBRUARY, stringToMonthCode("2")); 
assertEquals(MARCH, stringToMonthCode("3")); 
assertEquals(APRIL, stringToMonthCode("4")); 
assertEquals(MAY, stringToMonthCode("5")); 
assertEquals(JUNE, stringToMonthCode("6")); 
assertEquals(JULY, stringToMonthCode("7")); 
assertEquals(AUGUST, stringToMonthCode("8")); 
assertEquals(SEPTEMBER, stringToMonthCode("9")); 
assertEquals(OCTOBER, stringToMonthCode("10")); 
assertEquals(NOVEMBER, stringToMonthCode("11")); 
assertEquals(DECEMBER, stringToMonthCode("12")); 


todo assertEquals(-1, stringToMonthCode("0")); 
assertEquals(-1, stringToMonthCode("13")); 


assertEquals(-1,stringToMonthCode("Hello")); 


for (int m = 1; m <= 12; m++) { 
assertEquals(m, stringToMonthCode(monthCodeToString(m, 
assertEquals(m, stringToMonthCode(monthCodeToString(m, 


} 


assertEquals(1, stringToMonthCode("jan") 
assertEquals(2,stringToMonthCode("feb") 
assertEquals(3,stringToMonthCode("mar") 
assertEquals(4,stringToMonthCode("apr") 
assertEquals(5, stringToMonthCode("may") 
assertEquals(6, stringToMonthCode("jun") 
assertEquals(7,stringToMonthCode("jul") 
assertEquals(8, stringToMonthCode("aug") 
assertEquals(9,stringToMonthCode("sep")); 
assertEquals(10, stringToMonthCode("oct") ) 
assertEquals(11, stringToMonthCode("nov") ); 
assertEquals(12, stringToMonthCode("dec") ) 


assertEquals(1,stringToMonthCode(" JAN") 
assertEquals(2,stringToMonthCode("FEB") 
assertEquals(3,stringToMonthCode( "MAR" ) 
assertEquals(4,stringToMonthCode( "APR" ) 
assertEquals(5,stringToMonthCode( "MAY" ) 
) 
) 
) 





assertEquals(6,stringToMonthCode(" JUN" 
assertEquals(7,stringToMonthCode(" JUL" 
assertEquals(8,stringToMonthCode( "AUG" 
assertEquals(9,stringToMonthCode("SEP") 
assertEquals(10,stringToMonthCode( "OCT" 
assertEquals(11,stringToMonthCode( "NOV" 
assertEquals(12,stringToMonthCode( "DEC" 





); 
); 
); 
assertEquals(1,stringToMonthCode("january")); 
assertEquals(2, stringToMonthCode("february")); 
assertEquals(3,stringToMonthCode("march")); 
assertEquals(4,stringToMonthCode("april")); 
assertEquals(5,stringToMonthCode("may")); 
assertEquals(6,stringToMonthCode("june")); 
assertEquals(7,stringToMonthCode("july")); 
assertEquals(8,stringToMonthCode("august")); 
assertEquals(9,stringToMonthCode("september")); 
assertEquals(10,stringToMonthCode("october")); 
assertEquals(11,stringToMonthCode("november")); 
assertEquals(12,stringToMonthCode("december")); 


assertEquals(1,stringToMonthCode(" JANUARY" )) ; 
assertEquals(2,stringToMonthCode( "FEBRUARY")); 
assertEquals(3,stringToMonthCode("MAR")); 
assertEquals(4, stringToMonthCode("APRIL")); 
assertEquals(5, stringToMonthCode("MAY") ); 
assertEquals(6, stringToMonthCode("JUNE") ); 
assertEquals(7,stringToMonthCode("JULY")) ; 
assertEquals(8, stringToMonthCode("AUGUST") ); 
assertEquals(9, stringToMonthCode("SEPTEMBER") ); 
assertEquals(10, stringToMonthCode( "OCTOBER" ) ); 
assertEquals(11, stringToMonthCode( "NOVEMBER" ) ); 
assertEquals(12, stringToMonthCode( "DECEMBER" ) ); 


} 


public void testIsValidweekInMonthCode() throws Exception { 
for (int w = 0; w <= 4; w++) { 
assertTrue(isValidWeekInMonthCode(w)); 


} 
assertFalse(isValidWeekInMonthCode(5)); 
H 


public void testIsLeapYear() throws Exception { 
assertFalse(isLeapYear(1900)); 
assertFalse(isLeapYear(1901)); 
assertFalse(isLeapYear(1902)); 


false))); 
true))); 


227 assertFalse(isLeapYear(1903)); 








228 assertTrue(isLeapYear(1904)); 
229 assertTrue(isLeapYear(1908)); 
230 assertFalse(isLeapYear(1955)); 
231 assertTrue(isLeapYear(1964)); 
232 assertTrue(isLeapYear(1980)); 
233 assertTrue(isLeapYear (2000) ); 
234 assertFalse(isLeapYear (2001) ); 
235 assertFalse(isLeapYear (2100) ); 
236 } 
237 
238 public void testLeapYearCount() throws Exception { 
239 assertEquals(0, leapYearCount(1900)); 
240 assertEquals(0, leapYearCount(1901)); 
241 assertEquals(0, leapYearCount(1902)); 
242 assertEquals(0, leapYearCount(1903)); 
243 assertEquals(1, leapYearCount(1904)); 
244 assertEquals(1, leapYearCount(1905)); 
245 assertEquals(1, leapYearCount(1906)); 
246 assertEquals(1, leapYearCount(1907)); 
247 assertEquals(2, leapYearCount(1908)); 
248 assertEquals(24, leapYearCount(1999)); 
249 assertEquals(25, leapYearCount(2001)); 
250 assertEquals(49, leapYearCount(2101)); 
251 assertEquals(73, leapYearCount(2201)); 
252 assertEquals(97, leapYearCount(2301)); 
253 assertEquals(122, leapYearCount(2401)); 
254 } 
255 
256 public void testLastDayOfMonth() throws Exception { 
257 assertEquals(31, lastDayOfMonth(JANUARY, 1901)); 
258 assertEquals(28, lastDayOfMonth(FEBRUARY, 1901)); 
259 assertEquals(31, lastDayOfMonth(MARCH, 1901)); 
260 assertEquals(30, lastDayOfMonth(APRIL, 1901)); 
261 assertEquals(31, lastDayOfMonth(MAY, 1901)); 
262 assertEquals(30, lastDayOfMonth(JUNE, 1901)); 
263 assertEquals(31, lastDayOfMonth(JULY, 1901)); 
264 assertEquals(31, lastDayOfMonth(AUGUST, 1901)); 
265 assertEquals(30, lastDayOfMonth(SEPTEMBER, 1901)); 
266 assertEquals(31, lastDayOfMonth(OCTOBER, 1901)); 
267 assertEquals(30, lastDayOfMonth(NOVEMBER, 1901)); 
268 assertEquals(31, lastDayOfMonth(DECEMBER, 1901)); 
269 assertEquals(29, lastDayOfMonth(FEBRUARY, 1904)); 
270 } 
271 
272 public void testAddDays() throws Exception { 
273 SerialDate newYears = d(1, JANUARY, 1900); 
274 assertEquals(d(2, JANUARY, 1900), addDays(1, newYears)); 
275 assertEquals(d(1, FEBRUARY, 1900), addDays(31, newYears)); 
276 assertEquals(d(1, JANUARY, 1901), addDays(365, newYears)); 
277 assertEquals(d(31, DECEMBER, 1904), addDays(5 * 365, newYears)); 
278 } 
279 
280 private static SpreadsheetDate d(int day, int month, int year) {return new 
SpreadsheetDate(day, month, year);} 
281 
282 public void testAddMonths() throws Exception { 
283 assertEquals(d(1, FEBRUARY, 1900), addMonths(1, d(1, JANUARY, 1900))); 
284 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(31, JANUARY, 1900))); 
285 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(30, JANUARY, 1900))); 
286 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(29, JANUARY, 1900))); 
287 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(28, JANUARY, 1900))); 
288 assertEquals(d(27, FEBRUARY, 1900), addMonths(1, d(27, JANUARY, 1900))); 
289 
290 assertEquals(d(30, JUNE, 1900), addMonths(5, d(31, JANUARY, 1900))); 
291 assertEquals(d(30, JUNE, 1901), addMonths(17, d(31, JANUARY, 1900))); 
292 
293 assertEquals(d(29, FEBRUARY, 1904), addMonths(49, d(31, JANUARY, 1900))); 
294 
295 } 
296 
297 public void testAddYears() throws Exception { 
298 assertEquals(d(1, JANUARY, 1901), addYears(1, d(1, JANUARY, 1900))); 
299 assertEquals(d(28, FEBRUARY, 1905), addYears(1, d(29, FEBRUARY, 1904))); 
300 assertEquals(d(28, FEBRUARY, 1905), addYears(1, d(28, FEBRUARY, 1904))); 
301 assertEquals(d(28, FEBRUARY, 1904), addYears(1, d(28, FEBRUARY, 1903))); 
302 } 
303 
304 public void testGetPreviousDayOfWeek() throws Exception { 
305 assertEquals(d(24, FEBRUARY, 2006), getPreviousDayOfWeek( FRIDAY, 
d(1, MARCH, 2006))); 
306 assertEquals(d(22, FEBRUARY, 2006), getPreviousDayOfWeek (WEDNESDAY, 
d(1, MARCH, 2006))); 
307 assertEquals(d(29, FEBRUARY, 2004), getPreviousDayOfWeek (SUNDAY, 


d(3, MARCH, 2004))); 
308 assertEquals(d(29, DECEMBER, 2004), getPreviousDayOfWeek (WEDNESDAY, 


// 


d(5, JANUARY, 2005))); 


try { 
getPreviousDayOfWeek(-1, d(1, 


JANUARY, 2006)); 


fail("Invalid day of week code should throw exception"); 
} catch (IllegalArgumentException e) { 


public void testGetFollowingDayOfWeek() throws Exception { 
assertEquals(d(1, JANUARY, 2005), getFollowingDayOfWeek (SATURDAY, 


d(25, DECEMBER, 2004))); 


assertEquals(d(1, JANUARY, 2005), getFollowingDayOfWeek (SATURDAY, 


d(26, DECEMBER, 2004))); 
assertEquals(d(3, MARCH, 2004), 
d(28, FEBRUARY, 2004))); 


try { 
getFollowingDayOfWeek(-1, d(1, 


getFollowingDayOfWeek (WEDNESDAY, 


JANUARY, 2006)); 


fail("Invalid day of week code should throw exception"); 
} catch (IllegalArgumentException e) { 


J 
} 


public void testGetNearestDayOfWeek() throws Exception { 


assertEquals(d(16, APRIL, 2006), 
assertEquals(d(16, APRIL, 2006), 
assertEquals(d(16, APRIL, 2006), 


APRIL, 2006))); 


369 
370 


// 


// 


// 


// 


// 


// 


// 


// 


// 


// 


// 


assertEquals(d(16, APRIL, 2006), 
assertEquals(d(23, APRIL, 2006), 
assertEquals(d(23, APRIL, 2006), 
assertEquals(d(23, APRIL, 2006), 


todo assertEquals(d(17, APRIL, 
d(16, APRIL, 2006))); 
assertEquals(d(17, APRIL, 2006), 
assertEquals(d(17, APRIL, 2006), 
assertEquals(d(17, APRIL, 2006), 
assertEquals(d(17, APRIL, 2006), 
assertEquals(d(24, APRIL, 2006), 
assertEquals(d(24, APRIL, 2006), 


getNearestDayOfWeek(SUNDAY, d(16, APRIL, 2006))); 
getNearestDayOfWeek(SUNDAY, d(17, APRIL, 2006))); 
getNearestDayOfWeek(SUNDAY, d(18 


getNearestDayOfWeek(SUNDAY, d(19, APRIL, 2006))); 
getNearestDayOfWeek(SUNDAY, d(20, APRIL, 2006))); 
getNearestDayOfWeek(SUNDAY, d(21, APRIL, 2006))); 
getNearestDayOfWeek(SUNDAY, d(22, APRIL, 2006))); 


2006), getNearestDayOfWeek (MONDAY, 


getNearestDayOfWeek(MONDAY, d(17, APRIL, 2006))); 
getNearestDayOfWeek(MONDAY, d(18, APRIL, 2006))); 
getNearestDayOfWeek(MONDAY, d(19, APRIL, 2006))); 
getNearestDayOfWeek(MONDAY, d(20, APRIL, 2006))); 
getNearestDayOfWeek(MONDAY, d(21, APRIL, 2006))); 
getNearestDayOfWeek(MONDAY, d(22, APRIL, 2006))); 








assertEquals(d(18, APRIL, 2006), getNearestDayOfWeek(TUESDAY, 


d(16, APRIL, 2006))); 


assertEquals(d(18, APRIL, 2006), getNearestDayOfWeek(TUESDAY, 


d(17, APRIL, 2006))); 
assertEquals(d(18, APRIL, 2006), 
assertEquals(d(18, APRIL, 2006), 
assertEquals(d(18, APRIL, 2006), 
assertEquals(d(18, APRIL, 2006), 
assertEquals(d(25, APRIL, 2006), 


getNearestDayOfWeek(TUESDAY, d(18, APRIL, 2006))); 
getNearestDayOfWeek(TUESDAY, d(19, APRIL, 2006))); 
getNearestDayOfWeek(TUESDAY, d(20, APRIL, 2006))); 
getNearestDayOfWeek(TUESDAY, d(21, APRIL, 2006))); 
getNearestDayOfWeek(TUESDAY, d(22, APRIL, 2006))); 


assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY 


d(16, APRIL, 2006))); 


assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 


d(17, APRIL, 2006))); 


assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 


d(18, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), 
d(19, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), 
d(20, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), 
d(21, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), 
d(22, APRIL, 2006))); 


getNearestDayOfWeek (WEDNESDAY, 
getNearestDayOfWeek (WEDNESDAY, 
getNearestDayOfWeek (WEDNESDAY, 


getNearestDayOfWeek (WEDNESDAY, 


assertEquals(d(13, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 


d(16, APRIL, 2006))); 


assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 


d(17, APRIL, 2006))); 


assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 


d(18, APRIL, 2006))); 


assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 


d(19, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), 
d(20, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), 
d(21, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), 
d(22, APRIL, 2006))); 


getNearestDayOfWeek (THURSDAY, 
getNearestDayOfWeek (THURSDAY, 


getNearestDayOfWeek( THURSDAY, 


assertEquals(d(14, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(16, APRIL, 2006))); 
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// assertEquals(d(14, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(17, APRIL, 2006) 
// assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(18, APRIL, 2006) 
// assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(19, APRIL, 2006) 
// assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(20, APRIL, 2006) 
assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(21, APRIL, 2006))) 
assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(22, APRIL, 2006))) 


// assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(16, APRIL, 2006))); 
Si assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(17, APRIL, 2006))); 
// assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(18, APRIL, 2006))); 
// assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(19, APRIL, 2006))); 
// assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(20, APRIL, 2006))); 
// assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(21, APRIL, 2006))); 
assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(22, APRIL, 2006))); 


try { 
getNearestDayOfWeek(-1, d(1, JANUARY, 2006)); 


fail("Invalid day of week code should throw exception"); 
} catch (IllegalArgumentException e) { 
J 
} 


public void testEndOfCurrentMonth() throws Exception { 
SerialDate d - SerialDate.createInstance(2); 
assertEquals(d(31, JANUARY, 2006), d.getEndOfCurrentMonth(d(1, JANUARY, 2006))); 
assertEquals(d(28, FEBRUARY, 2006), d.getEndOfCurrentMonth(d(1, FEBRUARY, 2006))); 
assertEquals(d(31, MARCH, 2006), d.getEndOfCurrentMonth(d(1, MARCH, 2006))); 
assertEquals(d(30, APRIL, 2006), d.getEndOfCurrentMonth(d(1, APRIL, 2006))); 
assertEquals(d(31, MAY, 2006), d.getEndOfCurrentMonth(d(1, MAY, 2006))); 
assertEquals(d(30, JUNE, 2006), d.getEndOfCurrentMonth(d(1, JUNE, 2006))); 
assertEquals(d(31, JULY, 2006), d.getEndOfCurrentMonth(d(1, JULY, 2006))); 
assertEquals(d(31, AUGUST, 2006), d.getEndOfCurrentMonth(d(1, AUGUST, 2006))); 
assertEquals(d(30, SEPTEMBER, 2006), d.getEndOfCurrentMonth 
(d(1, SEPTEMBER, 2006))); 
assertEquals(d(31, OCTOBER, 2006), d.getEndOfCurrentMonth(d(1, OCTOBER, 2006))); 
assertEquals(d(30, NOVEMBER, 2006), d.getEndOfCurrentMonth(d(1, NOVEMBER, 2006))); 
assertEquals(d(31, DECEMBER, 2006), d.getEndOfCurrentMonth(d(1, DECEMBER, 2006))); 
assertEquals(d(29, FEBRUARY, 2008), d.getEndOfCurrentMonth(d(1, FEBRUARY, 2008))); 


} 


public void testWeekInMonthToString() throws Exception { 
assertEquals("First",weekInMonthToString(FIRST WEEK IN MONTH)); 
assertEquals("Second",weekInMonthToString(SECOND WEEK IN MONTH)); 
assertEquals("Third",weekInMonthToString(THIRD WEEK IN MONTH)); 
assertEquals("Fourth",weekInMonthToString(FOURTH WEEK IN MONTH)); 
assertEquals("Last",weekInMonthToString(LAST WEEK IN MONTH)); 


//todo try { 
// weekInMonthToString(-1); 
77: fail("Invalid week code should throw exception"); 
// } catch (IllegalArgumentException e) { 
// } 
} 


public void testRelativeToString() throws Exception { 
assertEquals("Preceding", relativeToString(PRECEDING) ); 
assertEquals("Nearest", relativeToString(NEAREST) ); 
assertEquals("Following", relativeToString(FOLLOWING) ); 


//todo try { 
// relativeToString(-1000); 
// fail("Invalid relative code should throw exception"); 
// } catch (IllegalArgumentException e) { 
// } 
} 


public void testCreateInstanceFromDDMMYYY() throws Exception { 
SerialDate date = createInstance(1, JANUARY, 1900); 
assertEquals(1,date.getDayOfMonth()); 
assertEquals(JANUARY, date.getMonth()); 
assertEquals(1900,date.getYYYY()); 
assertEquals(2,date.toSerial()); 


} 


public void testCreateInstanceFromSerial() throws Exception { 
assertEquals(d(1, JANUARY, 1900),createInstance(2)); 
assertEquals(d(1, JANUARY, 1901), createInstance(367)); 


} 


449 public void testCreateInstanceFromJavaDate() throws Exception { 


450 assertEquals(d(1, JANUARY, 1900), 
createInstance(new GregorianCalendar(1900,0,1).getTime())); 
451 assertEquals(d(1, JANUARY, 2006), 


createInstance(new GregorianCalendar(2006,0,1).getTime())); 


452 } 

453 

454 public static void main(String[] args) { 

455 junit.textui.TestRunner.run(BobsSerialDateTest.class); 
456 } 

457 } 


代码 清单 B-5 SpreadsheetDate.java 














1 /* ====== ====================: ====================: ================= 

2 * JCommon : a free general purpose class library for the Java(tm) platform 

3 * ====== ============================================================= 

4 * 

5 * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or modify it 
10 * under the terms of the GNU Lesser General Public License as published by 
11 * the Free Software Foundation; either version 2.1 of the License, or 
12 * (at your option) any later version. 

13 * 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser General Public 

20 * License along with this library; if not, write to the Free Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
22 * USA. 

23 4 

24 * [Java is a trademark or registered trademark of Sun Microsystems, Inc. 
25 * in the United States and other countries.] 

26 * 

27 人 

28 * SpreadsheetDate.java 

29 er ETT RA 

30 * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

eT * 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): - 

34 * 

35 * $Id: SpreadsheetDate.java,v 1.8 2005/11/03 09:25:39 mungady Exp $ 

36 * 

37 * Changes 

38 * ------- 

39 * 11-Oct-2001 : Version 1 (DG); 

40 * 05-Nov-2001 : Added getDescription() and setDescription() methods (DG); 
41 * 12-Nov-2001 : Changed name from ExcelDate.java to SpreadsheetDate.java (DG); 
42 * Fixed a bug in calculating day, month and year from serial 
43 * number (DG); 

44 * 24-Jan-2002 : Fixed a bug in calculating the serial number from the day, 
45 * month and year. Thanks to Trevor Hills for the report (DG); 
46 * 29-May-2002 : Added equals(Object) method (SourceForge ID 558850) (DG); 
47 * 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

48 * 13-Mar-2003 : Implemented Serializable (DG); 

49 * 04-Sep-2003 : Completed isInRange() methods (DG); 

50 * 05-Sep-2003 : Implemented Comparable (DG); 

51 * 21-Oct-2003 : Added hashCode() method (DG); 

52 * 

53. */ 

54 

55 package org.jfree.date; 

56 


57 import java.util.Calendar; 
58 import java.util.Date; 


59 

60 /** 

61 * Represents a date using an integer, in a similar fashion to the 

62 * implementation in Microsoft Excel. The range of dates supported is 

63 * 1-Jan-1900 to 31-Dec-9999. 

64 * «p» 

65 * Be aware that there is a deliberate bug in Excel that recognises the year 
66 * 1900 as a leap year when in fact it is not a leap year. You can find more 
67 * information on the Microsoft website in article Q181370: 


* 
* 
* 
* 
* 
* 
* 
* 
* 
79. *7 
80 public class SpreadsheetDate extends SerialDate { 
81 
82 /** For serialization. */ 
83 private static final long serialVersionUID - -2039586705374454461L; 
84 
85 rid 
86 * The day number (1-Jan-1900 = 2, 2-Jan-1900 = 3, ..., 31-Dec-9999 = 
87 * 2958465). 
88 d 
89 private int serial; 
90 
91 /** The day of the month (1 to 28, 29, 30 or 31 depending on the month). */ 
92 private int day; 
93 
94 /** The month of the year (1 to 12). */ 
95 private int month; 
96 
97 /** The year (1900 to 9999). */ 
98 private int year; 
99 
100 /** An optional description for the date. */ 
101 private String description; 
102 
103 for 
104 * Creates a new date instance. 
105 * 
106 @param day the day (in the range 1 to 28/29/30/31). 


* 
107 * @param month the month (in the range 1 to 12). 
* 


108 @param year the year (in the range 1900 to 9999). 

109 x7 

110 public SpreadsheetDate(final int day, final int month, final int year) { 
111 

112 if ((year >= 1900) && (year <= 9999)) { 

113 this.year = year; 

114 } 

115 else { 

116 throw new IllegalArgumentException( 

117 "The 'year' argument must be in range 1900 to 9999." 

118 ys 

119 } 

120 

121 if ((month >= MonthConstants. JANUARY ) 

122 && (month <= MonthConstants.DECEMBER)) { 

123 this.month = month; 

124 } 

125 else ( 

126 throw new IllegalArgumentException( 

127 "The 'month' argument must be in the range 1 to 12." 

128 ); 

129 } 

130 

131 if ((day >= 1) && (day <= SerialDate.lastDayOfMonth(month, year))) { 
132 this.day - day; 

133 } 

134 else { 

135 throw new IllegalArgumentException("Invalid 'day' argument."); 
136 } 

137 

138 // the serial number needs to be synchronised with the day-month-year.. 
139 this.serial = calcSerial(day, month, year); 

140 

141 this.description = null; 

142 

143 } 

144 

145 JE 

146 * Standard constructor - creates a new date object representing the 
147 * specified day number (which should be in the range 2 to 2958465. 
148 * 

149 * Qparam serial the serial number for the day (range: 2 to 2958465). 
150 kA 

isi public SpreadsheetDate(final int serial) { 

152 

153 if ((serial >= SERIAL_LOWER_BOUND) && (serial <= SERIAL_UPPER_BOUND)) { 
154 this.serial = serial; 

155 } 

156 else { 

157 throw new IllegalArgumentException( 

158 "SpreadsheetDate: Serial must be in range 2 to 2958465."); 
159 } 


68 * <P> 

69 * http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 

70 <P> 

71 Excel uses the convention that 1-Jan-1900 - 1. This class uses the 

72 convention 1-Jan-1900 - 2. 

73 The result is that the day number in this class will be different to the 

74 Excel figure for January and February 1900...but then Excel adds in an extra 
75 day (29-Feb-1900 which does not actually exist!) and from that point forward 
76 the day numbers will match. 

77 

78 @author David Gilbert 
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// the day-month-year needs to be synchronised with the serial number... 
calcDayMonthYear(); 


} 


y** 
* Returns the description that is attached to the date. It is not 
* required that a date have a description, but for some applications it 
* is useful. 
* 
* @return The description that is attached to the date. 
*/ 
public String getDescription() { 
return this.description; 
} 


/** 
* Sets the description for the date. 
* Qparam description the description for this date (<code>null</code> 
* permitted). 
*/ 
public void setDescription(final String description) { 
this.description - description; 
} 


/** 
* Returns the serial number for the date, where 1 January 1900 - 2 
* (this corresponds, almost, to the numbering system used in Microsoft 
* Excel for Windows and Lotus 1-2-3). 


* 


* 


@return The serial number of this date. 
ay 
public int toSerial() { 
return this.serial; 
} 


/** 
* Returns a <code>java.util.Date</code> equivalent to this date. 
* 
* @return The date. 
*/ 
public Date toDate() { 
final Calendar calendar = Calendar.getInstance(); 
calendar.set(getYYYY(), getMonth() - 1, getDayOfMonth(), 0, 0, 0); 
return calendar .getTime(); 


} 


/** 
* Returns the year (assume a valid range of 1900 to 9999). 
* 

* Qreturn The year. 
ud 

public int getYYYY() { 

return this.year; 

j 


Jt 
* Returns the month (January = 1, February = 2, March = 3). 
* 

* @return The month of the year. 
* 
/ 
public int getMonth() { 
return this.month; 
} 


ye 
* Returns the day of the month. 
* @return The day of the month. 
wa 
public int getDayOfMonth() { 
return this.day; 
} 


/** 
* Returns a code representing the day of the week. 
* «p» 
* The codes are defined in the {@link SerialDate} class as: 
* <code>SUNDAY</code>, <code>MONDAY</code>, <code>TUESDAY</code>, 
* <code>WEDNESDAY</code>, <code>THURSDAY</code>, <code>FRIDAY</code>, and 
* <code>SATURDAY</code>. 

* 

* 

* 


@return A code representing the day of the week. 
/ 
public int getDayOfWeek() { 
return (this.serial * 6) ?6 7 * 1; 
} 


/** 
* Tests the equality of this date with an arbitrary object. 
* «p» 
This method will return true ONLY if the object is an instance of the 
{@link SerialDate} base class, and it represents the same day as this 
{@link SpreadsheetDate}. 


* 


* 


* 
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* Qparam object 
* 


the object to compare (<code>null</code> permitted). 


* @return A boolean. 


uA 


public boolean equals(final Object object) { 


if (object instanceof SerialDate) { 
final SerialDate s - (SerialDate) object; 


return (s.toSerial() -- this.toSerial()); 
} 
else { 
return false; 
} 
} 
Jee 


* Returns a hash code for this object instance. 


* 


* @return A hash code. 


*/ 


public int hashCode() { 
return toSerial(); 


} 
yee 


* Returns the difference (in days) between this date and the specified 


'other' date. 


@param other 


* 
* 
* 
* 
* 
* 
* 


/ 


the date being compared to. 


@return The difference (in days) between this date and the specified 
'other' date. 


public int compare(final SerialDate other) { 
return this.serial - other.toSerial(); 


} 
LE 


* Implements the method required by the Comparable interface. 


@param other 


+ + + RR OF 


/ 


the other object (usually another SerialDate). 


@return A negative integer, zero, or a positive integer as this object 
is less than, equal to, or greater than the specified object. 


public int compareTo(final Object other) { 
return compare((SerialDate) other); 


} 
yee 


* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


@param other 


the 


o OR OR 并 站 


/ 


the date being compared to. 


@return <code>true</code> if this SerialDate represents the same date as 


specified SerialDate. 


public boolean isOn(final SerialDate other) { 
return (this.serial -- other.toSerial()); 


} 
yee 


* Returns true if this SerialDate represents an earlier date compared to 


* the specified 


@param other 


+ oe Oe 并 并 站 


4 


SerialDate. 


the date being compared to. 


@return <code>true</code> if this SerialDate represents an earlier date 
compared to the specified SerialDate. 


public boolean isBefore(final SerialDate other) { 
return (this.serial < other.toSerial()); 


} 
yu 


* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


@param other 


++ ROO 


^ 


the date being compared to. 


@return <code>true</code> if this SerialDate represents the same date 
as the specified SerialDate. 


public boolean isOnOrBefore(final SerialDate other) { 


return (this. 


} 
yee 


serial <= other.toSerial()); 


* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other 


the date being compared to. 
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* 
74 
pub 


} 
yee 


* 


@return <code>true</code> if this SerialDate represents the same date 


as the specified SerialDate. 


lic boolean isAfter(final SerialDate other) { 
return (this.serial > other.toSerial()); 


Returns true if this SerialDate represents the same date as the 


* specified SerialDate. 


ee OF 


/ 
pub 


} 
yee 


* 


* 
* 
* 
* 
* 
* 
* 
* 


/ 


public boolean isInRange(final SerialDate di, final SerialDate d2) { 


i 


public boolean isInRange(final SerialDate d1, final SerialDate d2, 


private int calcSerial(final int d, final int m, final int y) { 
final int yy = ((y - 1900) * 365) + SerialDate.leapYearCount(y - 1); 
int mm = SerialDate.AGGREGATE DAYS TO END OF PRECEDING MONTH[m]; 


} 
LZ 


* 


*/ 


@param other the date being compared to. 


@return <code>true</code> if this SerialDate represents the same date as 


the specified SerialDate. 


lic boolean isOnOrAfter(final SerialDate other) { 
return (this.serial »- other.toSerial()); 


Returns <code>true</code> if this {@link SerialDate) is within the 
specified range (INCLUSIVE). The date order of d1 and d2 is not 


important. 


@param di a boundary date for the range. 
@param d2 the other boundary date for the range. 


Qreturn A boolean. 


return isInRange(di, d2, SerialDate.INCLUDE BOTH); 


Returns true if this SerialDate is within the specified range (caller 
specifies whether or not the end-points are included). 


and d2 is not important. 


@param di one boundary date for the range. 
@param d2 a second boundary date for the range. 


@param include a code that controls whether or not the start and end 


dates are included in the range. 


@return <code>true</code> if this SerialDate is within the specified 


range. 


final int include) { 
final int s1 di.toSerial(); 
final int s2 - d2.toSerial(); 
final int start = Math.min(s1, s2); 
final int end - Math.max(si, s2); 


final int s - toSerial(); 
if (include -- SerialDate.INCLUDE BOTH) ( 
return (s »- start && s «- end); 


} 
else if (include == SerialDate.INCLUDE_FIRST) { 
return (s >= start && s < end); 


} 
else if (include == SerialDate.INCLUDE_SECOND) { 
return (s > start && s <= end); 


} 
else { 

return (s > start && s < end); 
} 


Calculate the serial number from the day, month and year. 


<P> 

1-Jan-1900 = 2. 
@param d the day. 
@param m the month. 
@param y the year. 


@return the serial number from the day, month and 


if (m > MonthConstants.FEBRUARY) { 
if (SerialDate.isLeapYear(y)) { 
mm = mm + 1; 
} 
} 


final int dd = d; 
return yy + mm + dd + 1; 


Calculate the day, month and year from the serial 


year. 


number. 


The order of d1 
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private void calcDayMonthYear() { 


// get the year from the serial date 

final int days - this.serial - SERIAL LOWER BOUND; 

// overestimated because we ignored leap days 

final int overestimatedYYYY = 1900 + (days / 365); 

final int leaps = SerialDate.leapYearCount(overestimatedYYYY) ; 
final int nonleapdays - days - leaps; 

// underestimated because we overestimated years 

int underestimatedYYYY = 1900 + (nonleapdays / 365); 


if (underestimatedYYYY == overestimatedYYYY) { 
this.year - underestimatedYYYY; 


} 
else { 
int ssi = calcSerial(1, 1, underestimatedYYYY); 
while (ssi <= this.serial) { 
underestimatedYYYY = underestimatedYYYY + 1; 
ssi = calcSerial(1, 1, underestimatedYYYY); 
} 
this.year = underestimatedYYYY - 1; 
} 


final int ss2 = calcSerial(1, 1, this.year); 


int[] daysToEndofPrecedingMonth 
= AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH; 


if (isLeapYear(this.year)) { 
daysToEndofPrecedingMonth 
= LEAP_YEAR_AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH; 
} 


// get the month from the serial date 
int mm = 1; 
int sss = ss2 + daysToEndOfPrecedingMonth[mm] - 1; 
while (sss < this.serial) { 

mm = mm + 1; 

sss = ss2 + daysToEndOfPrecedingMonth[mm] - 1; 
} 


this.month = mm - 1; 
// what's left is d(+1); 


this.day = this.serial - ss2 
- daysToEndOfPrecedingMonth[this.month] + 1; 
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(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


Project Info: http://www. jfree.org/jcommon/index.html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries. ] 


(C) Copyright 2000-2003, by Object Refinery Limited and Contributors. 


Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): -; 
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$Id: RelativeDayOfWeekRule.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 


Changes (from 26-Oct-2001) 


26-Oct-2001 : Changed package to com.jrefinery.date.*; 
03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 


/ 


package org.jfree.date; 


/* 


* 


* 


ox RR X OF 


pu 


* 


An annual date rule that returns a date for each year based on (a) a 
reference rule; (b) a day of the week; and (c) a selection parameter 
(SerialDate.PRECEDING, SerialDate.NEAREST, SerialDate.FOLLOWING). 

<P> 

For example, Good Friday can be specified as 'the Friday PRECEDING Easter 
Sunday'. 


@author David Gilbert 
/ 
blic class RelativeDayOfWeekRule extends AnnualDateRule { 


/** A reference to the annual date rule on which this rule is based. */ 
private AnnualDateRule subrule; 


/** 
* The day of the week (SerialDate.MONDAY, SerialDate.TUESDAY, and so on). 
* 

/ 
private int dayOfWeek; 


/** Specifies which day of the week (PRECEDING, NEAREST or FOLLOWING). */ 
private int relative; 


/** 
* Default constructor - builds a rule for the Monday following 1 January. 
* 

/ 
public RelativeDayOfWeekRule() { 
this(new DayAndMonthRule(), SerialDate.MONDAY, SerialDate.FOLLOWING); 
} 


/** 
* Standard constructor - builds rule based on the supplied sub-rule. 





@param subrule the rule that determines the reference date. 

@param dayOfWeek the day-of-the-week relative to the reference date. 

@param relative indicates *which* day-of-the-week (preceding, nearest 
or following). 


*ox kk OF 


/ 

public RelativeDayOfWeekRule(final AnnualDateRule subrule, 
final int dayOfWeek, final int relative) { 

this.subrule = subrule; 

this.dayOfWeek = dayOfWeek; 

this.relative - relative; 


} 


/** 
* Returns the sub-rule (also called the reference rule). 


* 


* @return The annual date rule that determines the reference date for this 


* rule. 
x 
public AnnualDateRule getSubrule() { 
return this.subrule; 
3 


/** 
* Sets the sub-rule. 
* @param subrule the annual date rule that determines the reference date 
t for this rule. 
rA 
public void setSubrule(final AnnualDateRule subrule) { 
this.subrule = subrule; 
} 


/** 
* Returns the day-of-the-week for this rule. 
* Qreturn the day-of-the-week for this rule. 
f 

public int getDayOfWeek() { 

return this.dayOfWeek; 
} 


/** 
* Sets the day-of-the-week for this rule. 
* Qparam dayOofWeek the day-of-the-week (SerialDate.MONDAY, 
x SerialDate.TUESDAY, and so on). 
*/ 

public void setDayOfWeek(final int dayOfWeek) { 

this.dayOfWeek = dayOfWeek; 
} 
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/** 
* Returns the 'relative' attribute, that determines *which* 
* day-of-the-week we are interested in (SerialDate.PRECEDING, 
* SerialDate.NEAREST or SerialDate.FOLLOWING). 
* 
* @return The 'relative' attribute. 
* 
/ 
public int getRelative() { 
return this.relative; 
3 


/** 
* Sets the 'relative' attribute (SerialDate.PRECEDING, SerialDate.NEAREST, 
* SerialDate.FOLLOWING). 

* 
* Qparam relative determines *which* day-of-the-week is selected by this 
* rule. 
*/ 
public void setRelative(final int relative) { 
this.relative = relative; 
F 


/** 
* Creates a clone of this rule. 


* 





* @return a clone of this rule. 

* Qthrows CloneNotSupportedException this should never happen. 

*/ 

public Object clone() throws CloneNotSupportedException { 
final RelativeDayOfWeekRule duplicate 
= (RelativeDayOfWeekRule) super.clone(); 

duplicate.subrule - (AnnualDateRule) duplicate.getSubrule().clone(); 
return duplicate; 


} 


/** 
* Returns the date generated by this rule, for the specified year. 


* 


@param year the year (1900 <= year <= 9999). 


* @return The date generated by the rule for the given year (possibly 
* <code>null</code>). 
* 


public SerialDate getDate(final int year) { 


// check argument... 
if ((year « SerialDate.MINIMUM YEAR SUPPORTED) 
|| (year > SerialDate.MAXIMUM YEAR SUPPORTED)) { 
throw new IllegalArgumentException( 
"RelativeDayOfWeekRule.getDate(): year outside valid range."); 
} 


// calculate the date... 
SerialDate result = null; 
final SerialDate base = this.subrule.getDate(year); 


if (base != null) { 
switch (this.relative) { 
case(SerialDate.PRECEDING) : 
result = SerialDate.getPreviousDayOfWeek(this.dayOfWeek, 
base); 
break; 
case(SerialDate.NEAREST): 
result = SerialDate.getNearestDayOfWeek(this.dayOfWeek, 
base); 
break; 
case(SerialDate. FOLLOWING) : 
result = SerialDate.getFollowingDayOfWeek(this.dayOfWeek, 
base); 





break; 
default: 
break; 
了 
了 


return result; 


lass library f 





or the Java(tm) platform 
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* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


* 


/ 


package org.jfree.date; 


import java.io.Serializable; 
import java.util.*; 


/ 


An abstract class that represents immutable dates with a precision of 


one day. 


The implementation will map each date to an integer that 


represents an ordinal number of days from some fixed origin. 


Why not just use java.util.Date? We will, when it makes sense. At times, 


java.util 


.Date can be *too* precise - it represents an instant in time, 


accurate to 1/1000th of a second (with the date itself depending on the 


time-zone 


). Sometimes we just want to represent a particular day (e.g. 21 


January 2015) without concerning ourselves about the time of day, or the 
time-zone, or anything else. That's what we've defined DayDate for. 


Use DayDateFactory.makeDate to create an instance. 


Qauthor David Gilbert 
@author Robert C. Martin did a lot of refactoring. 


} 








blic abstract class DayDate implements Comparable, Serializable { 
public abstract int getOrdinalDay(); 

public abstract int getYear(); 

public abstract Month getMonth(); 

public abstract int getDayOfMonth(); 


protected abstract Day getDayOfWeekForOrdinalZero(); 
public DayDate plusDays(int days) { 
return DayDateFactory.makeDate(getOrdinalDay() + days); 


public DayDate plusMonths(int months) { 


int thisMonthAsOrdinal - getMonth().toInt() - Month.JANUARY.toInt(); 
int thisMonthAndYearAsOrdinal = 12 * getYear() + thisMonthAsOrdinal; 


int resu 
int resu 
int resu 


tMonthAndYearAsOrdinal = thisMonthAndYearAsOrdinal + months; 
tYear - resultMonthAndYearAsOrdinal / 12; 
tMonthAsOrdinal = resultMonthAndYearAsOrdinal % 12 + Month.JANUARY.toInt(); 


Month resultMonth - Month.fromInt(resultMonthAsOrdinal); 


int resu 


tDay - correctLastDayOfMonth(getDayOfMonth(), resultMonth, resultYear); 


return DayDateFactory.makeDate(resultDay, resultMonth, resultYear); 


} 


public DayDate plusYears(int years) { 


int resu 
int resu 


tYear = getYear() + years; 
tDay = correctLastDayOfMonth(getDayOfMonth(), getMonth(), resultYear); 


return DayDateFactory.makeDate(resultDay, getMonth(), resultYear); 


} 


private in 





t correctLastDayOfMonth(int day, Month month, int year) { 


int lastDayOfMonth = DateUtil.lastDayOfMonth(month, year); 
if (day » lastDayOfMonth) 


day - lastDayOfMonth; 


return day; 


} 


public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
if (offsetToTarget >= 0) 


offsetToTarget -= 7; 


return plusDays(offsetToTarget); 


} 


public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget - targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
if (offsetToTarget «- 0) 


offsetToTarget += 7; 


return plusDays(offsetToTarget); 


} 





public DayDate getNearestDayOfWeek(Day targetDayOfWeek) { 
int offsetToThisWeeksTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) % 7; 
int offsetToPreviousTarget = offsetToFutureTarget - 7; 





if (offsetToFutureTarget > 3) 


return 
else 
return 


plusDays(offsetToPreviousTarget) ; 


plusDays(offsetToFutureTarget); 


public DayDate getEndOfMonth() { 
Month month = getMonth(); 


int year 


- getYear(); 


int lastDay - DateUtil.lastDayOfMonth(month, year); 
return DayDateFactory.makeDate(lastDay, month, year); 


} 


public Date toDate() { 























137 } 

138 

139 public Day getDayOfWeek() { 

140 Day startingDay - getDayOfWeekForOrdinalZero(); 

141 int startingOffset - startingDay.toInt() - Day.SUNDAY.toInt(); 
142 int ordinalOfDayOfWeek = (getOrdinalDay() + startingOffset) % 7; 
143 return Day.fromInt(ordinalOfDayOfWeek + Day.SUNDAY.toInt()); 
144 } 

145 

146 public int daysSince(DayDate date) { 

147 return getOrdinalDay() - date.getOrdinalDay() 

148 } 

149 

150 public boolean isOn(DayDate other) ( 

151 return getOrdinalDay() == other.getOrdinalDay() 

152 ) 

153 

154 public boolean isBefore(DayDate other) { 

155 return getOrdinalDay() < other.getOrdinalDay(); 

156 ) 

157 

158 public boolean isOnOrBefore(DayDate other) { 

159 return getOrdinalDay() <= other.getOrdinalDay(); 

160 ) 

161 

162 public boolean isAfter(DayDate other) { 

163 return getOrdinalDay() > other.getOrdinalDay(); 

164 } 

165 

166 public boolean isOnOrAfter(DayDate other) { 

167 return getOrdinalDay() >= other.getOrdinalDay() 

168 } 

169 

170 public boolean isInRange(DayDate d1, DayDate d2) { 

171 return isInRange(d1, d2, DateInterval.CLOSED); 

172 } 

173 

174 public boolean isInRange(DayDate d1, DayDate d2, DateInterval interval) { 
175 int left = Math.min(di.getOrdinalDay(), d2.getOrdinalDay()); 
176 int right = Math.max(d1.getOrdinalDay(), d2.getOrdinalDay()); 
177 return interval.isIn(getOrdinalDay(), left, right); 

178 3 

179 ) 





代码 清单 B-8 Month.java (最 终 版 本 ) 





1 package org.jfree.date; 

2 

3 import java.text.DateFormatSymbols; 

4 

5 public enum Month { 

6 — JANUARY(1), FEBRUARY(2), MARCH(3), 

7  APRIL(4),  MAY(5), JUNE(6), 

8  JULY(7), AUGUST(8), ”SEPTEMBER(9)， 


9  OCTOBER(10),NOVEMBER(11),DECEMBER(12); 
10 private static DateFormatSymbols dateFormatSymbols - new DateFormatSymbols(); 
11 private static final int[] LAST DAY OF MONTH - 








12 (0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31); 
13 

14 private int index; 

15 

16 Month(int index) { 

17 this.index - index; 

18 } 

19 

20 public static Month fromInt(int monthIndex) { 
21 for (Month m : Month.values()) { 

22 if (m.index -- monthIndex) 

23 return m; 

24 } 

25 throw new IllegalArgumentException("Invalid month index " + monthIndex); 
26 } 

27 

28 public int lastDay() { 

29 return LAST_DAY_OF_MONTH[ index]; 

30 ) 

31 

32 public int quarter() { 

33 return 1 + (index - 1) / 3; 

34 } 


129 final Calendar calendar = Calendar.getInstance() 

130 int ordinalMonth - getMonth().toInt() - Month.JANUARY.toInt(); 

131 calendar.set(getYear(), ordinalMonth, getDayOfMonth(), 0, 0, 0); 

132 return calendar.getTime(); 

133 } 

134 

135 public String toString() { 

136 return String. format("%02d-%s-%d", getDayOfMonth(), getMonth(), getYear()); 


65 } 
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tring toString() { 
dateFormatSymbols.getMonths()[index - 1]; 


tring toShortString() { 
dateFormatSymbols.getShortMonths()[index - 1]; 


tatic Month parse(String s) { 
trim(); 

onth m : Month.values()) 
m.matches(s)) 

turn m; 


rn fromInt(Integer.parseInt(s)); 
(NumberFormatException e) {} 


new IllegalArgumentException("Invalid month " + s); 


boolean matches(String s) { 
s.equalsIgnoreCase(toString()) || 
s.equalsIgnoreCase(toShortString()); 


nt toInt() { 
index; 


package org.jfree.date; 


import java.util.Calendar; 
import java.text.DateFormatSymbols; 


public enum Day { 


alendar.MONDAY), 
Calendar.TUESDAY), 
Y(Calendar.WEDNESDAY), 
(Calendar.THURSDAY), 
alendar.FRIDAY), 
(Calendar.SATURDAY), 
alendar.SUNDAY); 


final int index; 
static DateFormatSymbols dateSymbols - new DateFormatSymbols(); 


day) { 
- day; 


tatic Day fromInt(int index) throws IllegalArgumentException { 
ay d : Day.values()) 

d.index -- index) 

turn d; 

new IllegalArgumentException( 

ng.format("Illegal day index: %d.", index)); 


tatic Day parse(String s) throws IllegalArgumentException { 
] shortWeekdayNames = 

Symbols .getShortWeekdays(); 

] weekDayNames = 

Symbols .getwWeekdays(); 


trim(); 

ay day : Day.values()) { 
s.equalsIgnoreCase(shortWeekdayNames[day.index]) || 
s.equalsIgnoreCase(weekDayNames[day.index])) { 
turn day; 





new IllegalArgumentException( 
ng.format("%s is not a valid weekday string", s)); 


tring toString() { 
dateSymbols.getWeekdays() [index] 


nt toInt() { 
index; 





代码 清单 B-9 Day. java (最 终 版 本 ) 








>= left && d < right; 


1 
ean isIn(int d, int left, 
» left && d «- right; 














ean isIn(int d, int left, 
»- left && d «- right; 











blic abstract boolean isIn(int d, int left, int right); 





代码 清单 B-11 WeekInMonth.java (最 终 版 本 ) 


package org.jfree.date; 


public enum WeekInMonth { 
FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 
private final int index; 


WeekInMonth(int index) { 
this.index - index; 


} 


public int toInt() { 
return index; 
} 
3 





代码 清单 B-12 WeekdayRange.java (最 终 版 本 ) 


package org.jfree.date; 


public enum WeekdayRange { 
LAST, NEAREST, NEXT 
} 





代码 清单 B-13 DateUtil.java (最 终 版 本 ) 





1 package org.jfree.date; 

2 

3 import java.text.DateFormatSymbols; 

4 

5 public class DateUtil { 

6 private static DateFormatSymbols dateFormatSymbols = new DateFormatSymbols(); 
Y: 

8 public static String[] getMonthNames() { 

9 return dateFormatSymbols.getMonths(); 

10 ) 

11 

12 public static boolean isLeapYear(int year) { 





13 boolean fourth = year % 4 == 0; 


代码 清单 B-10 DateInterval.java (最 终 版 本 ) 
package org.jfree.date; 
public enum DateInterval { 
OPEN { 
blic boolean isIn(int d, in i 
turn d » left && d « right; 
i ean isIn(int d, int left, 





28 int leapi100 (year - 1800) / 100; 


29 int leap400 (year - 1600) / 400; 
30 return leap4 - leap100 + leap400; 
31 ) 

32 } 





代码 清单 B-14 DayDateFactory.java (最 终 版 本 ) 


package org.jfree.date; 


public abstract class DayDateFactory { 

private static DayDateFactory factory - new SpreadsheetDateFactory(); 

public static void setInstance(DayDateFactory factory) { 
DayDateFactory.factory - factory; 

} 


protected abstract DayDate _makeDate(int ordinal); 

protected abstract DayDate _makeDate(int day, Month month, int year); 
protected abstract DayDate _makeDate(int day, int month, int year); 
protected abstract DayDate _makeDate(java.util.Date date); 

protected abstract int _getMinimumYear(); 

protected abstract int _getMaximumYear(); 


public static DayDate makeDate(int ordinal) { 
return factory. makeDate(ordinal); 


} 


blic static DayDate makeDate(int day, Month month, int year) { 
return factory._makeDate(day, month, year); 


blic static DayDate makeDate(int day, int month, int year) { 
return factory._makeDate(day, month, year); 








blic static DayDate makeDate(java.util.Date date) { 
return factory. makeDate(date); 





blic static int getMinimumYear() { 
return factory. getMinimumYear(); 














blic static int getMaximumYear() { 
return factory. getMaximumYear(); 











代码 清单 B-15 SpreadsheetDateFactory.java (最 终 版 本 ) 





1 package org.jfree.date; 
2 
3 import java.util.*; 
4 
5 public class SpreadsheetDateFactory extends DayDateFactory { 
6 public DayDate _makeDate(int ordinal) { 
T. return new SpreadsheetDate(ordinal); 
8 Jj 
9 
10 public DayDate _makeDate(int day, Month month, int year) { 
11 return new SpreadsheetDate(day, month, year) 
12 ) 
13 
14 public DayDate _makeDate(int day, int month, int year) { 
15 return new SpreadsheetDate(day, month, year); 
16 ) 
17 
18 public DayDate _makeDate(Date date) { 














14 boolean hundredth = year % 100 == 

15 boolean fourHundredth = year % 400 == 0; 

16 return fourth && (!hundredth || fourHundredth); 
AT 于 

18 

19 public static int lastDayOfMonth(Month month, int year) { 
20 if (month -- Month.FEBRUARY && isLeapYear(year)) 
24. return month.lastDay() * 1; 

22 else 

23 return month.lastDay(); 

24 } 

25 

26 public static int leapYearCount(int year) { 

27 int leap4 = (year - 1896) / 4; 








25 } 

26 

27 protected int _getMinimumYear() { 

28 return SpreadsheetDate.MINIMUM_YEAR_SUPPORTED; 
29 } 

30 

31 protected int _getMaximumYear() { 

32 return SpreadsheetDate.MAXIMUM YEAR SUPPORTED; 
33 } 

34 } 





代码 清单 B-16 SpreadsheetDate.java (最 终 版 本 ) 








for the J 





ava(tm) platform 


(C) Copyright 2009-2005, by Object Refinery Limited and Contributors. 


* 
* 
* 
* 
* 
* 


55 package org.jfree.date; 

57 import static org.jfree.date.Month.FEBRUARY; 
59 import java.util.*; 

61 /** 


62 * Represents a date using an integer, in a similar fashion to the 
63 * implementation in Microsoft Excel. The range of dates supported is 


64 * 1-Jan-1900 to 31-Dec-9999. 

65 * <p/> 

66 * Be aware that there is a deliberate bug in Excel that recognises the year 

67 * 1900 as a leap year when in fact it is not a leap year. You can find more 

68 * information on the Microsoft website in article Q181370: 

69 * <p/> 

70 * http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 

71 * «p/» 

72 * Excel uses the convention that 1-Jan-1900 = 1. This class uses the 

73 * convention 1-Jan-1900 = 2. 

74 * The result is that the day number in this class will be different to the 

75 * Excel figure for January and February 1900...but then Excel adds in an extra 
76 * day (29-Feb-1900 which does not actually exist!) and from that point forward 
77 * the day numbers will match. 

A8. F 

79 * @author David Gilbert 

80 */ 

81 public class SpreadsheetDate extends DayDate { 

82 public static final int EARLIEST DATE ORDINAL - 2; // 1/1/1900 


83 public static final int LATEST DATE ORDINAL - 2958465; // 12/31/9999 
84 public static final int MINIMUM YEAR SUPPORTED - 1900; 

85 public static final int MAXIMUM YEAR SUPPORTED - 9999; 

86 static final int[] AGGREGATE DAYS TO END OF PRECEDING MONTH - 





87 (0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365); 

88 static final int[] LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH - 
89 (0, ©, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366}; 

90 

91 private int ordinalDay; 

92 private int day; 

93 private Month month; 

94 private int year; 

95 

96 public SpreadsheetDate(int day, Month month, int year) ( 

97 if (year « MINIMUM YEAR SUPPORTED || year » MAXIMUM YEAR SUPPORTED) 
98 throw new IllegalArgumentException( 

99 "The 'year' argument must be in range " + 

100 MINIMUM YEAR SUPPORTED + " to " + MAXIMUM YEAR SUPPORTED + "."); 
101 if (day « 1 || day » DateUtil.lastDayOfMonth(month, year)) 

102 throw new IllegalArgumentException("Invalid 'day' argument."); 
103 

104 this.year - year; 

105 this.month = month; 

106 this.day - day; 

107 ordinalDay - calcOrdinal(day, month, year) 

108 } 

109 


110 public SpreadsheetDate(int day, int month, int year) { 


19 final GregorianCalendar calendar = new GregorianCalendar(); 
20 calendar.setTime(date); 

21 return new SpreadsheetDate( 

22 calendar .get (Calendar .DATE), 

23 Month.fromInt(calendar.get(Calendar.MONTH) + 1), 

24 calendar.get(Calendar.YEAR)); 

111 this(day, Month.fromInt(month), year); 


} 


public SpreadsheetDate(int serial) { 
if (serial < EARLIEST DATE ORDINAL || serial > LATEST_DATE_ORDINAL) 
throw new IllegalArgumentException( 
"SpreadsheetDate: Serial must be in range 2 to 2958465."); 


ordinalDay = serial; 
calcDayMonthYear(); 
} 


public int getOrdinalDay() { 
return ordinalDay; 
} 


public int getYear() { 
return year; 
} 


public Month getMonth() { 
return month; 
3 


public int getDayOfMonth() { 
return day; 
} 


protected Day getDayOfWeekForOrdinalZero() (return Day.SATURDAY; } 











public boolean equals(Object object) { 
if (!(object instanceof DayDate) ) 
return false; 


DayDate date = (DayDate) object; 
return date.getOrdinalDay() == getOrdinalDay(); 
} 


public int hashCode() { 
return getOrdinalDay(); 
} 


public int compareTo(Object other) { 
return daysSince((DayDate) other) 
} 


private int calcordinal(int day, Month month, int year) { 
int leapDaysForYear = DateUtil.leapYearCount(year - 1); 
int daysUpToYear = (year - MINIMUM YEAR SUPPORTED) * 365 + leapDaysForYear; 
int daysUpToMonth = AGGREGATE DAYS TO END OF PRECEDING MONTH[month.toInt()]; 
if (DateUtil.isLeapYear(year) && month.toInt() » FEBRUARY.toInt()) 
daysUpToMonth++; 
int daysInMonth = day - 1; 
return daysUpToYear + daysUpToMonth + daysInMonth + EARLIEST_DATE_ORDINAL; 
} 


private void calcDayMonthYear() { 
int days = ordinalDay - EARLIEST DATE ORDINAL; 
int overestimatedYear = MINIMUM YEAR SUPPORTED + days / 365; 
int nonleapdays - days - DateUtil.leapYearCount(overestimatedYear); 
int underestimatedYear = MINIMUM YEAR SUPPORTED + nonleapdays / 365; 


year - huntForYearContaining(ordinalDay, underestimatedYear); 

int firstOrdinalofYear = firstOrdinalOfYear(year); 

month = huntForMonthContaining(ordinalDay, firstOrdinalofYear) ; 

day = ordinalDay - firstOrdinalofYear - daysBeforeThisMonth(month.toInt()); 
} 


private Month huntForMonthContaining(int anOrdinal, int firstOrdinalofYear) { 
int daysIntoThisYear = anOrdinal - firstOrdinalofYear; 
int aMonth - 1; 
while (daysBeforeThisMonth(aMonth) « daysIntoThisYear) 
aMonth++; 





return Month.fromInt(aMonth - 1); 
} 


private int daysBeforeThisMonth(int aMonth) { 
if (DateUtil.isLeapYear(year)) 
return LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH[aMonth] - 1; 
else 
return AGGREGATE DAYS TO END OF PRECEDING MONTH[aMonth] - 1; 
3 


private int huntForYearContaining(int anOrdinalDay, int startingYear) { 
int aYear = startingYear; 
while (firstOrdinalOfYear(aYear) <= anOrdinalDay) 
aYear++; 


return aYear - 1; 


} 


private int firstOrdinalofYear(int year) { 
return calcOrdinal(1, Month.JANUARY, year); 
} 


207 public static DayDate createInstance(Date date) { 


208 GregorianCalendar calendar - new GregorianCalendar(); 

209 calendar.setTime(date); 

210 return new SpreadsheetDate(calendar.get(Calendar.DATE), 

211 Month.fromInt(calendar.get(Calendar.MONTH) + 1), 
212 calendar.get(Calendar.YEAR)); 

213 

214 } 











结束 语 


2005 年 ， 在 参加 于 丹佛 举行 的 敏捷 大 会 时 ， 
Elisabeth Hedrickson [H 递 给 我 一 条 类 似 Lance 
Armstrong 热 销 的 那 种 绿色 腕 市 。 这 条 腕 禹 上 面 写 
着 “沉迷 测试 ”(Test Obsessed) 的 字样 。 我 高 兴 地 
mk, JFARHL-BAG. E1999 E Kent Beck 
那儿 学 到 TDD 以 来 ， 我 的 确 迷 上 了 测试 驱动 开发 。 


MIRER E EFR. RAMAH ALAR 
下 腕 市 。 不 仅 是 因为 胶带 很 案 ， 而 且 那 也 是 条 精神 
EMA TTC. ADEL ETRAS ET Ux 
我 承 语 尺 已 所 能 写 出 最 好 代码 的 提示 。 取 下 它 ， 念 
佛 就 是 违背 了 这 些 宣告 和 承诺 似 的 。 所 以 它 还 在 我 
的 手腕 上 。 在 写 代 码 时 ， 我 用 余 光 眶 见 它 。 它 一 直 
提醒 我 ， 我 做 了 写 出 整洁 代码 的 承 话 。 





[1] JRE: http://www.qualitytree.com/ 。 


欢迎 来 到 寞 步 社 区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 
社 旗下 IT 专业 图 书 旗舰 社区 ， 于 2015 年 8 月 上 线 运 


异步 社区 依托 于 人 民 邮 电 出 版 社 20 余 年 的 IT 专 
业 优 质 出 版 资源 和 编辑 策划 团队 ， 打 造 传统 出 版 与 
电子 出 版 和 自 出 版 结合 、 纸 质 书 与 电子 书 结合 、 传 
统 印 刷 与 POD 按 需 印 刷 结合 的 出 版 平 台 ， 拥 供 最 新 
技术 资讯 ， 为 作者 和 读者 打造 交流 互动 的 平台 。 











CCIE 路 举 和 交接 认证 稚 数 奖 科学 实战 手册 ithe : 代码 之 外 的 生 Python ZB S efe 
EB ( SER) ( 第 1 ( R+Python ) 存 指 商 
卷 ) 





Python PARERE ”机 器 学 习 项 目 开 发 实战 。 DIEEWPythondSÉRA|] 像 计 算 机 科学 京 一 样 畦 
= 与 实战 ( 第 2 版 ) "EPython (第 2 版 ) 





iREB Ah 


THES IBEX PIER ! 


PETES FRETLEERELA Res Hee ek 
IT 专业 图 书 齐 航 社 区 ,于 2015 年 8 月 上 线 运 
营 ， 界 步 社区 依托 于 人 民 闻 电 出 版 社 20% SERSIT 


ane iWebi$ Sit 555846718 , AHTMLSS 


每 一 次 拍 去 高 呼 嫩 里 行业 的 影响 ， 每 一 天 无 数 人 
sm dyagENE. 201639! 未 吧 ，8 月 27 日 ， 
HTML5 妖 会 北京 站 ,我 在 这 里 ,等 你 末 , A 
HTMLSHPKE ! ... 


WE 6( "m1 收藏 评论 
每 周 半 价 宅 子 书 Bs 


— 


=~ BIBRPythonsGEA ISA (382 


(28) Richard Blum $5825, Christine 
Bresnahan 布 柔 斯 纳 罕 (作者 ) [88585 
Sys (SE) 





AX BABA TA? 
购买 图 书 


我 们 出 版 的 图 书 涵盖 主流 IT 技 术 ， 在 编程 语 
言 、Web 技 术 、 数 据 科 学 等 领域 有 众多 经 典 畅 销 图 
书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 400 多 
种 ， 部 分 新 书 实现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 
会 定期 发 布 新 书 书 讯 。 


FRAI 


社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 
程序 源 代码 。 


为 外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 
注册 成 为 社区 用 户 融 可 以 免费 下 载 。 


与 作 详 者 互动 


很 多 图 书 的 作 译 者 已 经 入 驻 社区 ， 您 可 以 关注 
他 们 ， 咨 询 技术 问题 ， 可 以 阅读 不 断 更 新 的 技术 文 
草 ， 听 作 诺 者 和 编辑 畅 聊 好 书 育 后 有 趣 的 故事 ;还 
可 以 参与 社区 的 作者 访谈 栏目 ， 疝 您 关注 的 作者 所 








H. 


Iq 


出 采访 有 


灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 
纸 质 图 书 直 接 从 人 民 邮 电 出 版 社 书 库 发 贷 ， 电 子 书 
提供 多 种 阅读 格式 。 


对 于 重 人 磅 新 书 ， 社 区 提供 预 售 和 新 书 首发 服 
务 ， 用 户 可 以 第 一 时 间 买 到 心仪 的 新 书 。 


用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 
Sd 购买 图 书 时 ， 在 


里 填 入 可 使 用 的 积 
分 数值 ， 即 可 扣 减 相应 金额 。 
特别 优惠 


购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 使 用 方法 : 注册 成 为 
社区 用 户 ， 在 下 单 购书 时 输入 “57AWG ”， 然 后 点 击 “ 使 用 优惠 码 ”， 即 
可 至 受 电子 书 8 折 优 囊 (本 优惠 券 只 可 使 用 一 次 ) 。 


纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购 买方 
却 ， 价 格 优惠 ， 一 次 购买 ， 多 种 阅读 选择 。 





软 技能 : 代码 之 外 的 生存 指南 

[Š] Z. FBS (John Z Sonmez ) (作者 ) 王 小 刚 (FS) hiss Sew) 
C 6 ?* 90k 
JF EPF mum 阅读 


这 星 一 本 真正 从 “人 ”【( 而 非 按 术 也 非 管 理 ) 的 角度 关注 软件 开发 人 员 已 身 发 展 的 蔬 。 书 中 论述 的 
内 容 茎 涉及 生活 习 悍 ,又 包括 导 维 方式 ,总 显 技术 中 “人 ”的 因素 ， 全面 洪 解 软 件 行业 从 业 人 员 所 
需 知 道 的 所 有 “ 软 技能 ”。 

本 书 暴 焦 于 软件 开发 人 员 生 活 的 方方面面 , 从 更 秘 画 试 的 流程 到 精 耕 绍 作出 一 份 杀手 级 简历 , Me! 
建 大 过 欢迎 的 博客 到 打 和 址 你 的 个 人 品牌 ， 从 提高 号 己 工 作 效 至 到 与 如 何 与 “ 疮 延 首 ”做 斗争 ， 基 至 
包括 如 何 投资 不 动产 ， 如何 关注 富 己 的 健康 ， 

本 书 共 分 为 职业 简 、 生 我 营销 简 、 学 习 简 、 生 产 力 简 、 理 财 简 、 健 身 简 、 精 神 簿 等 七 简 ， 概括 了 软 


* ER 5900 着 46.02(78 折 ) 
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社区 里 还 可 以 做 什么 ? 
提交 勘误 

您 可 以 在 图 书页 面 下 方 提 交 勘 误 ， 每 条 勘误 被 
确认 后 可 以 获得 100 积 分 。 热 心 勘 误 的 读者 还 有 机 
会 参与 书稿 的 审 校 和 翻译 工作 。 
ade 

社区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写 
作 的 您 可 以 在 此 一 试 丑 手 ， 在 社区 里 分 享 您 的 技术 
心得 和 读书 体会 ， 更 可 以 体验 上 日 出 版 的 乐趣 ， 轻 松 
实现 出 版 的 梦想 。 


如 果 成 为 社区 认证 作 译 者 ， 还 可 以 圣 受 寞 步 社 
区 提供 的 作者 专 圣 特色 服务 。 


会 议 活动 早 知 道 


SAY CASITA Mot, ADL oe 
费 获 赠 大 会 门票 。 


























加 入 异步 


扫描 任意 二 维 码 都 能 找到 我 们 : 








微 信服 务 号 











QQ 和 群 : 368449889 


社区 网 址 : www.epubit.com.cn 


官方 微 信 : 异步 社区 


官方 微 博 : @ 人 邮 和 异步 社区 ，@ 人 民 邮 电 出 版 
社 -信息 技 术 分 社 
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